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REVISIONS ~ a ca ss See 6 


Changes for Mark 10.0] elease ee can ae d 
3-37 Updated system input messages. | 


Updated "All the underlined..." paragraph. - 

~ Gel2 ne Added "and status changes" to "The mechanism ‘has 
been designed..." paragraph. 

4-13 Added "'c. Any status change messages throughout 


the job's Life." 
Updated "The underscore under QU..." paragraph. 


- 4al4 Added “h. Any status nes message throughout 
the’ job's life. 


4-16 Updated "The underscore under US..." paragraph. 

4-17 - Added "In general, session numbers" sentence to 
_ SESSION COMMAND. 

4-18 Added "RESTRICTIONS COMMAND." : 

4-19 - Added "Type = 09 - RJE status change message." 


' Added '8. BNA node address of five characters 
("00000" = local)." 


4-20 | Updated "Type 02" and "Type 05" messages. 
Added '( syntax. errors or CANCELLED)" and 
"5 = Death in Family" to Type 06 message. 


421 Added "Type 09" message. . 
4-25 Updated "One SPO command was implemented..." ‘para. : 
4-26 Changed "PIN or PROTECTION" to "SEC or SECURITYTYPE' 


and "PLO or PROTEC.IO" to "SUS or SECURITYUSE” 
in "Two new file attributes..." paragraph. 


4-30 | Changed "PROTECTION" to "SECURITYTYPE' and — 
"PROTECT.10" to "SECURITYUSE". throughout 
"FILE ACCESS" section. 
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REVISIONS 


Deleted "USERCODE SPECIFIED IN uc" message and | 
renumbered remaining error messages, Added 
messages 16 and 17: "#WARNING: DIRECTORY NEARLY 
FULL" and "#WARNING; WORKFILE NEARLY: FULL". 

Added "#USERCONE...LOGGED OFF, JOBS ACTIVE"; 
added discussion of SWI 

Deleted "UC HOST SYSTEM INPUT MESSAGE’* 
(formerly page 3-57) 

Referenced "LOG ON AND OFF MESSAGES" and "ID 
REMOTE INPUT MESSAGE" in LOG ON procedure. 

Added information on entering remote card decks 
to a job 


“Added explanation of "PUBLIC" attribute 


pace for “Mark VIL. 0 Release 
All references to B1700 changed to B1800/B1700 


2—3 
3—1 


3-9 & 3-10 
3-12 
3- 23 


3231 
3-34 


3=37 


3-43 


| 4-1 


4—5 
4-13 


4~16 


4—22 & 4-23 


4-25 = 4-28 


Added F. (Automatic CALLBACK feature) 

Added "All decks must be terminated by a ?END © 
card'':to REMOTE DECKS 

Added Remote Output Messages 16 through 19 
Added *PH to mnemonics of keyboard entries 
Added *PH Input Message 


Added CALLBACK to run-time remote terminal options 

Added Format 2 to *TO Input Message 

Underlined various System Input Messages to in-. 
dicate these commands require a valid usercdde © 
and password 

Added System Output Error Messages 18 through 21- 

Added "Each Line may have only one remote 
satellite system..." to General Description of 
RJE Controller 

Added CALLBACK 

Indicated only first two characters are necessary. 
for valid syntax of QUEUE command 

Indicated only first two characters are necessary 
for valid syntax of USER command 

Indicated two security violation conditions with © 
attempted use of the ''*'' or (Cusercode?) 
conventions 

Table 4-1 revised; discussion of A=N revised; 
further discussion (O0-W) added 
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PRODUCT SPECIFICATION 


REVISIONS 


a d\ ie De Updated to Mark 6.1 Release level 
} Restructured Table of Contents 
\ 3=2 Moved BACKUP FILE HANDLING section from page 3=30 tq 
page 3-2. 
3=4 Deleted three paragraphs from explanation of 
RJE/CONTROLLER OUTPUT MESSAGES. 
3=5 to 3-9 Added RJE SYSTEM REMOTE OUTPUT MESSAGES section. 
3=11 Added *ID, *LO, *PD, *RB, *RS, *SD to List of 
RJE INPUT MESSAGES. 
3=15 Added *ID input message explanation. 
3=22 Added *PD input message explanation. 
3=25 Added *RB input message explanation. 
3=27 Added *RS input message explanation. 
3-32 Added *SD input message explanation. 
3-40 Added section of HOST SYSTEM CONSOLE MESSAGES. 
3=41 to 3-45 Added section of RJE HOST SYSTEM OUTPUT ERROR MESSAGCI 
3-46 to 3-60 Added RJE HOST SYSTEM OPERATOR INPUT MESSAGES sectio 
3-63 to 3-65 Added RJEA: SYSTEM CONTROL MESSAGES section. 
4=18 Added Type 08 to #1. 
Changed #7. 
Added #8. 
4-19 Added explanation of Type 08. 
5el to 5—=5 Added section entitled GENERATING THE NETWORK 
CONTROLLER (RJE/NDLDCH). 
3=17 Added *LO input message explanation. 
C Additional 6.1 Updates 
3-4 _ Added explanation on blank passwords 
3=5 Added OUTPUT MESSAGE NO.2: "##END TRANSMISSION..’ 


3-6 to 3-9 Added OUTPUT MESSAGE No.3; "FILE file-name NOT 
PRESENT..'' Renumbered remaining messages 


3-16 Added second paragraph to *ID' INPUT MESSAGE 
3-18 Added further explanation to *LO INPUT MESSAGE 
3=19 Qualified *LO INPUT MESSAGE when used with 
*PB INPUT MESSAGE . 
3=25 Added paragraph on invalid *QT INPUT MESSAGE 
3=28 Qualified use of *LO INPUT MESSAGE with 
*RS INPUT MESSAGE 
3=29 Deleted *SB options (same as *PB options); 
referenced *PB options 
3-30 Qualified use of *LO INPUT MESSAGE with 
*SD INPUT MESSAGE 
3=39 Message #2: Qualified method of terminating RJE 
system . 
3=40 Message #4; Same as for Message #2 
3-44 Message #15: Same as for Message #2 
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GENERAL DESCRIPTION 


This document provides a detailed description of the remote job 
entry CRJE) host system for the 31806731706. 


Remote job entry utilizes data communications Lines and remote 
terminals to enable remote users to enter jobs for execution by a 
central Chost) data processing system. The purpose of any RJE 
system is to increase the availability and convenience of using a 
central Chost) data processing system which is Located some 
distance from the point at which the input data is produced = and 
the output data is required. 


A typical Burroughs RJE system is shown in Figure lel. 
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Figure lel RJE System Configuration 


The basic objectives of the HOST/RJE system are? 


As 


Be 


C. 


De 


The introduction of programs from a remote input device for 
compilation and/or execution by the host syster. 


The introduction of data decks from a remote input device 
for processing by pragrams resident at the host systeme 


Dispersing of data produced by the host system to the remote 
devices. 


Monitoring and controlling programs on the host system via a 
remote supervisory consote. 
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DESIGN O3JECTIVES 


The design of the HOST RJE system provides for the following: 


Aw The 81800/81795 system is compatible with Burroughs standard 


data communications tine discipline and message format 
conventions defined by the RJEWA specifications. 


Be The B1800/B1700 systew maintains RJE command Language 
compatibility with Burroughs large and medium systeas RJE. 


C. The B1899/81700 RJE system is transparent to the user (1.@ee 
remote control cards and MCP comsands are a subset of the 
BL1800/81700 host control card and coamands-) 


De A 867930 compatibie file security systesx is provided. 


The RJE system supports up to sixteen concurrent users. 
NETWORK CONTROLLER CNC) 


The Network Controlter (NC) is a Network ODOefinition Language 
C(NDL) generated program whose prime function ts to process and 
supervise the flow of messages between the Centrat System and 
Remote Satellite Systems. It performs the data communications 
Line discipline. The Network Controtler handles the initiation 
and completion of data communication I[/0 and services exception 
conditions. Typically» 81890/81700 message flow is handled in 
the following manner: 


Ae Upon receiving an error free message from a remote satellite 
system» the NC will queue the message (via a “queue fitie") 
for RJE/ CONTROLLER. 


Be RJESCONTROLLER with read the message from the queue and 
process ite 


C. Cn the output sides RJE/CONTROLLER queues MCP messages» 
output datas» etce» for the NC. 


DO. Upon receiving the message from RJE/CONTROLLER» NC will 
initiate the appropriate procedures to transmit the message 
to the designated remote satellite system. 
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RJE/CONTROLLER 


RJE/CONTROLLER is an MCS and is the heart of the 81860/81709 host 
KJE systeme. It can be thought of as the functional software 
interface between the 81800/31799 operating system and the remote 
sateltite system» in that atd input and outrut information passes 
through it. Some of the more significant functions of 


RJE/CONTROLLER are: 
A. tog on and log off functions. 


Be Receive jobs from remote satellite systens and schedute thea 
for eventual execution by the NCP. 


Ce Schedute the transfer of print and euinen backup files to the 
rewote sateilite SYSTEMS 


De Handle system commands from rensote satettlite systems» either 
passing them on to the MCP» oor processing thea directly in 
RJE/CONTROLLER. 

Es Handte the transfer of output wessages from the MCP to the 


appropriate remote satellite systems. 


F. Invoke the automatic CALLBACK feature after a remote user 
has LOGGED OFF with jobs stitl running. This altows another 
renote user to LOG ON and use the host processor while the 


jobs for the former remote user are coapteted. As soon as 
the jobs for the former remote user are completed» and a 
dial out line becomes available» the former user is 


automaticatty CALLED BACK and his output is transmitted to 
hitte . 
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SECURTTY CONVENTIONS 


A remote user has the ability to select names for files without 
having to be aware of names used by other remote users and at the 
same time has the ability to address host system site files. 
Howevere for the host system to perform litrary maintenance on 
all types of files» all file names sust be unique. 


To atlow remote users to be isolated from each other so far as 
file name selection is concerned» and at the same time maintain a 
systes of unique names to the central system» user identification 
can be assigned by the data processing manager to each user of 
the system. RJE/CONTROLLER obtains this user identification 
either by remote sateltite tlogton or by a speciai control card. 


The activation of a remote sateliite system is known as the 
"logon" procedure. This “lLagton” is accomplished by supplying 
RJE/CONTROLLER with aovatid usercode and password combination. 
The user is referred to the section entitled "LOGON AND LOGOFF 
MESSAGES" for information on the manner in which the user 
identification must be supplied. 


The usercode» if any» obtained from the “tog~en” procedure is the 
default usercode associated with job decks which are read from 
the remote reader and with such keyboard entries as "PD" entered 
from the Remote Supervisory Consote CRSC). Any USER control 
cards contained in the jot decks override this default usercode 
for the programs involved. 


REMOTE DECKS 


Decks acceptabte from the remote card reader are the same as 
decks acceptable at the central site with the exception that 


binary card decks are not atlowed. Programs cannot read cards 
directly from the remote reader. Ait card decks are spooled an 
disk before a program can read theme Att decks must be 


terminated by a “?END" card. 
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For aocumentation of the card decks that are acceptable» the user 
is referred to the Systems Software Operational Guider Fora 
Number 1068731. 


GACKUP FILE HANDLING 


Backup files generated by RJE-initiated jots are placed in a 
special directory maintained by RJE/CONTROLLER. 


The names of the backup files are: 
<usercode> / # <integer> 1 #4 <usercode> / % <integer> 


A "#" is used to indicate a printer backup files The 7%" 
signifies a punch backup file. 7 : 


REMDIE SUPERVISORY CONSOLE (RSC) 


A remote operator/system interface is provided to enable the 
operator to control the jobs submitted from the remote system. 
This feature is provided through output and input sessages via 
the remote supervisory console (RSC). 


CUIPUT MESSAGES 


There are four basic types of RSC output messages: tocals» tog-on 
and togroff» RJE» and system messagese The following paragraphs 
discuss these message typese 


LOCAL MESSAGES 


Locai messages are messages generated by the remote computer 


pertaining to its own control and error handlina. These include 
"reader hopper. enmpty™>» "printer out of paper» "nadem 
transmission error™» and other such messages- The format of 


these messages 1s dependent upon the tyre of RJE satetlite used 
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and is described in the documentation for the satellite system. 
~LUGTON AND LOG-QOFF MESSAGES 


To employ RJE in a secured-terminal environsent Ci.ee» one in 
which every user of an RJE terminal is required to supply the 
controller with acceptable usercodes and passwords) the following 
procedure must be followed. 


After establishing contact between the RJE terminal and the 
Bi890/B1700 Cky dialingrin»s etc)» RJE CONTROLLER will respond 
with the following message for the R&SCz 


fees 81809/81700 RJE HOST <time> <date> #USERCOCE. 


The RJE operator must then enter a valid usercode at the RSC or a 
valid usercode password combination (separated by blanks or a 
slash). If only a usercode has been entered» RJE/CONTROLLER wilt 
respond with: 


AAND YCUR PASSWORD. 


The correct response to this is a valid password entered at the 
RSC. Blank passwords are accepted by the RJE system either by 
entering a valid usercode foltowed by a stash and no passwords or 
by entering a nuil message at the RSC when a4 password is 
requested. The usercode and password are checked for validity. 
If they are invalid» then RJE/SCONTROLLER will respond with the 
RSC message? 


#SECURITY ERROR» ENTER USERCODE. 
and the usercode must be rementered» 1f the user identification 
entered is found to be valid»s RJE/CONTROLLER wilt respond with 
the following RSC message: | 

a<remote station name> LOGGED ON AT <time> <date>. 


“HSESSION <session numoder > 


The remote satettlite system may now proceed with job introduction 
and RSC activity. ; 
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and is described in the documentation for the satellite system. 
LOGTON AND LOG“QEF MESSAGES 


To eaploy RJE in a secured-terminal environsent Ci.ee» one in 
which every user of an RJE terminal is required to suppty the 
controller with acceptable usercodes and passwords) the following 
procedure must be followed. 


After establishing contact bcetween the RJE terminal and the 
B1690/B1700 Chy dialingtins etce)d»e RIESCONTROLLER will cespond 
with the fodlowing message for the ASCs 


feeee G1809/81700 RJE HOST <time> <date> #USERCODE. 


The RJE operator must then enter a valid usercode at the RSC or a 
valid usercode password combination (separated by btanks or a 
slash). If only a usercode has been entered» RIJE/COATROLLES witt 
respond withs 


HAND YCUR PASSWORD. 


The correct response to this is a valid password entered at the 
RSC. Blank passwords are accepted by the RJE system either by 
entering a valid usercode followed by a stash and no passwords or 
by entering a mnuihk message at the RSC when a password is 
requested. The usercode and password are checked for validity. 
If they are invalid» then RJE/SCONTROLLER will respond with the 
RSC message? 


#SECURITY ERROR» ENTER USERCODE. 


and the usercode must be re"enterede If the user identification 


entered is found to be valid» RJE/CONTROLLER will respond with 
the following RSC message: . _: | 


4<remote station name> LOGGED ON AT <time> <date>. 
#SESSION <session number >. 


The remote satetlite system may now proceed with job introduction 
and RSC activity. . 
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PUNCH 


5s 


FILE - SAVED °* 
PURGED 


Originator: RJE/AUTOBACKUP 


This message is sent whenever the transmission of a backup 
file to the remote site is terrinated abnormally» such as 
through a “**QT" message or if the remote device receiving 
the file goes doun. 


"#FILE <file-name> NOT PRESENT» NOT SENT.” 
Originator: RJE/AUTOBACKUP 


If a copy of RJE/AUTOBACKUP fs requested to send a backup 
file which is not eresent on the system to a remote 
satellite system» then this message will be sent to the &SC. 
The most tikely reason for this condition would te because 
the file resides on a pack which is not aon line at the host 
at the time the request is issued. The remote satettite 
system may request Cvia a SPO sxessage to the host SPO) that 
the pack be mounted and readied after which the file may te 
transmitted to the remote satellite system. 


"#FILE <file-name> - EOF REACHED NO RECORDS PROCESSED.” 
Originator? RJE/AUTOBACKUP © 


The KEY and RECORD options of the PB CPRINTER/PUNCH SACKUP) 
and $3 CSITE BACKUP) reaucte input #sessages cause 
RJE/JAUTOBACKUP to search a backup file according to the 
parameters supplied in these options. Shoutd RJE/AUTOBACKUP 
scan an entire file without finding a match for the 
parameters (Ci.ee» the range of records requested does not 
exist in the fide named)» then this message wilt tbe 
transmitted to the RSC. The file will be saved at the host 
system. 


“FILE <fil -name> LOCKED AS A DISK FILE.” 


Originator: RJE/CONTROLLER 
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7. 


This message is sent to the RSC whenever a remote card deck 
has been tocked on. the host system as a disk file. Any 
remote card deck not directly associated with a remote jot 
wilt be flocked as a disk file at the host computere 


"#FLUSHING CARD READER.” 


Originator: RJE/SCONTROLLER 


Several error conditions may initiate this message. Att 
incorging card decks to RJE/CONTROLLER must begin with 
controt cards. If the deck does not begin with contrat 
catds or there is an error in the deck itself» 
RJE/CONTROLLER sends this messages If a remote satettite 
system atteapts to send card images before tog on 15 
cosptete» RJE/CONTROLLER sends this message to the RSC. Ati 
card images are discarded until the rernote sateltite system 
is fully dogged on. 


"BINVALIO CONTROL MESSAGE RECEIVED." 
Originator: RJE/CONTROLLER 


The control messages referred to in this error message are 
Burroughs RJEA system controt sessages explained tater in 
this section. Should a message be received which is not 
defined for the system» the above gessage will be sent to 


the RSC. Also» the type 9 control sessage may only be sent 


immediately after log on and prior to any other input to the 
hoste If it is sent at any other tiwer this message will be 
sent to the RSC. j 
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Originator: RJE/CONTROLLER 


ALL RJE input messages have a specific formate ToGo an 
asterisk as the first non-blank character and an appropriate 
controt string. If a message tis received by RJE/HOST which 
does not conform to the defined format» #INV KEYIN is 
transmitted to the RSC. The incorrectly formatted message 
is discarded and the operator must reenter it» correcting 
the error. 


"#L0G OFF IN PROCESS READER PURGED.* 
Originator: RJE/CONTROLLER 


If a remote operator togs off while receiving output» remote 
satetlite systea wilt regain on tine until corgpletion of the 
transmissione At this time» however» no program input wit 
be peraitted. Should the operator atteupt to send a remote 
card decks it wild be discarded and this message sent to the 
RSC. An *LO message will return the remote satellite system 
to its prior state» enabling the operator to enter jobs. 


"#PACK <pack name> REQUIRED FOR USER <usercode>» RSN <RSN>.* 
Originator: RJE/CONTROLLER 


It is possible to set up a usercode to automatically require 
a specific pack when tog on occurse If RJE/CONTROLLER 
determines that the necessary pack is not on tine» the above 
nessage is sent to the RSC. The resgote satettite system 
cperator must then converse with the host system operator 
(via the RSC) to decide if the pack should be toaded. Once 
the pack is on Line» work way begine If» however» the host 
operator decides to override the pack request» the fotlowing 
message will be sent to the RSC. 


“#PACK REQUESTED HAS BEEN OVERRIDDEN TO SYSTEM DISK" 


n 
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lie "P68 OR SB INVALID SYNTAX.” 
Originator: RJEJAUTOBACKUP 


The text portion of an *PB or *SB message is not scanned Cy 
RJE/CONTROLLER but passed to and scanned hy RJE/AUTOBACKUP. 
Should this text prove to be in errors then the above 
message is sent to the RSC and the *PB or *S$8 discarded. 
The operator at the remote sateilite system must then 
correct the error and reenter the message. 


12.2 "#0T IN PROCESS." 
Originator: RJESCONTROLLER: 


A aT entered by the host operator will cause the RJE systea 
to log off every active user. Ail output ts saved and ati 
jobs which have been executed are allowed to complete. 
Immediately after the QT message has been entered» a "#QT IN 
PROCESS" is sent to aid active users tefore their tog off 
process begins. 


13. “SAVE IN PROCESS." 
Originator: RJE/CONTROLLER 


An SV entered by the host operator witt cause the user 
specified in the S¥ to be logged off. Adl output is saved 
and ali jobs are ailowed to complete. Iamediatety after the 
SV has been entered» the above message wilt be sent to the 
RSC and the user togged off. 
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SYSTEM QUIPUT MESSAGES 


Ail other messages displayed at the RSC are generated by the MCP. 
These messages have formats identical to these at the main system 
and inctude replies generated in response to system input 


messages entered at the RSC. (CSee section entitled “SYSTEM INFUT 
MESSAGES".) 


INPUT MESSAGES 


There are two basic types of RSC input messages: RJE input 
messages and system input messagese The fottowing paragraphs 
discuss these message types. 


RJE INPUT MESSAGES — 


RJE/CONTROLLER has been designed as an interface between the 
remote satellite system and the MCP which services its SC 
keyboard entries. Conpiete transparency of this interface is 
impossible since many RSC keyboard entries must be provided tg 
communicate directly with the RJE/CONTROLLER. Therefore» any RSC 
input message beginning with the character “** is handlea 
directiy by RJE/CONTROLLER. 


These RJE input messages provide controt cver the following areas 
of RJE/CONTROLLER activity: session togof f» debugging aids» 
Autobackup routine activity» States of RJE tersinat run-time 
options» datacomm reconfiguration» inter terminal communication>e 
and environgent interrogation. 
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The avaitable RJE input messages are discussed in the fotlowing 
paragraphs. The mnemonics of these keyboard entries are as 
follows: 


“BYE 
#CL 
aF M 
af) 
«LC 
«LO 
«PB 
*PD 
«PH 
«QT 
#RB 
#RO 
#RS 
#58 
#30 
a SF 
«50 
«$5 
«ITF 
«TQ 
eS 
«WM 
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 * BYE INPUT MESSAGE (LOGOFF) 


Format: «BYE 


The  *BYE input w#essaye causes the current session to te 
terminated. Any active jobs inittated by the satellite system 
are teft active. If the satetlite system is recetving a data 
stream» the stream will be allowed to compiete. If the satellite 
system is sending a job deck» the card reader is cleared and the 
deck is discarded. When transmitting over switchegd lines the 
satellite system is disconnected. 


Exampte: 


* BYE 
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CL INPUT MESSAGE CCLEAR UNIT) 


-For@at: «Cl or #CLEAR 


The *CL input message atlows the remote operator to clear the 
remote card reader. The host system witl purge any program 
currently being received from the satetlite system and will 
respond with the message “#CR CLEAR. 


Exampie: 


#CL 
*CLEAR 
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*FM INPUT MESSAGE CRESPONSE TO SPECIAL FORMS) 


Format? *FM <unit mnemonic> 


The *FM input message is a response to the “SPECIAL FORMS 
REQUIRED" message. The unit-mnemonic designates which unit is to 
be assigqned to the filee The message: 


"#SPECIAL FORMS REQUIRED ON PRINT FILE - <file name>" 
. PUNCH 


is displayed on the remote console printer and requires that an 
*FM o0message be submitted by the remote operator before the file 
can be transmitted. 


Exaaple: 


«FM LP 
*FM CP 
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#10 INPUT MESSAGE CREMOTE SITE IDENTIFIER) 


Format: *I0 = <id message> 


The *ID input message is to permit satellite systems to supply a 
sateilite system identifier to the host system. Some satetlite 
RJE implementations can send this message via a speciat controi 
message and wit not need this message while sone iaplementations 
Ceege» 001000) must use this command. The ID message may be up 
to 17 nonsblank characters in Length. 


This coamand wilt be accepted onty after tog ones and before any 
action by the host for the usere It may te entered any number of 
times if no other actions have occurred. If entered incorrectly» 
an error message witli be sent and the cogsand must be re~enteredr 
providing the originat error did not produce an error condition 
that has to be remedied first. 


Example: 


*ID = 012345678 
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“LC INPUT MESSAGE (LOG COMMENT) 


Format: *LC <text> 


The *LC input message allows the rewote operator to enter given 
text in the system's SPO log as an RJE/SCONTROLLER message entry 
associated with the current session number. The text is also 
displayed on the host console printer. The RJE/SCONTROLLER 
responds by disptaying "#" on the remote console printer. 


Examples 


*LC MESSAGE SYSTEMS SPO LOG 


ie ie 
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*L0 INPUT MESSAGE ¢€LOG-ON) 


Format: #*LQ 


The *«LO input message atlows the resote operator to bypass the 
LOG-ON frequirement.s. The *LQ message does not assign a usercode 
or password to the satellite system. Thereforer, each job entered 
from the satetltite systew must have a usercode and/or password 


control carde This message is only valid at logvon time. If a 
user logs on with this message» then input sessages which require 
knowledge of a remote site*s usercode wit! be disabled.. (ieee » 


*PBe *S5S8e «PD» *S5D» *RBe *KS). 


Example: 


#10 
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*PB INPUT MESSAGE CPRINTER/PUNCH BACKUP) 


Format 1) «PB J <job number > <option-l Loption-2Je..> 
2) *PB S <session number> <option-1l Coption~2]...> 
3) *PB8 ¢bhackup number> <option-l Copticn-2}...> 


4) *PB = <option-1 Coption=2)...> 


The *PB input message allows the satetlite system operator to 
initiate the transmission of a print or punch disk file to the 
satellite system. Format 1 transmits ail backup files that were 
created under the specified job nunaber. Forgat 2 transmits alt 
backup files that were created under the specified session 
number. Format 3 transmits the backup file specified by the 


backup number. Format 4 transmits all backup files that were 
created under the usercode with which the satellite systea 
LOGGED-ON. If a satetlite system has bypassed the LOG-ON 


procedure by using the *LO ingut messager the *PB with not be 
accepted since the *P8 will apply only to fites created under the 
remote operator's usercode.- 


OPTION FUNCTION 


COPLTES integer Causes RJE/AUTOBACKUP to produce integer 
copies of the specified tackup file. One copy 
is the default if this option is not 


specified. 


DOUBLE Causes RJE/AUTOBACKUP to doubde-space the 
entire printer Listing» overriding any 
carriage controt specified in the tackup file. 


KEY Allows specification of a range of records to 
be printed or punched. A detailed description 
of the syntax is given below. Ail records in 
the file wilt be printed or punched if this. 
optton is omitted. 


LABELCS) Allows the remote operator the abitity tq 
request the tabels of all tackup files to be 
printed on. the remote printer. This option is 
the only option that cannot have any other 
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option associated with ite 


RECORD range Ailows specification cof 4 range of records to 
be printed or puncheds. Output will tegin with 
the physical record specified by integer-1 
(the first record in the backup fite is record 
number 1) and continues untit the physical 
record specified by integer2. If integer-2 
is omitted» end-of-file is assumed as the 
terminator. Ail records in the file are 
printed or punched if this option is omitted. 


SAVE Causes RJE/JAUTOBACKUP to teave the backup file 
on disk when the file is closed. The file 
wild be removed fro#s disk if this option is 
omitted. 


SINGLE Causes RJE/AUTOBACKUP to singte-space the 


entire printer Listing» overriding any 
carriage control specified in the backup file. 


The complete syntax for the KEY option is: 


RAR eEKRaARKHKKKKKRahRaKE KEKE KK KK tkhktkkkkhkhhk hk ke tkehhhkkehkkkhk hk hh 


* compiter-name RANGE string-1 string-2 * 
i KEY Pa 
* .  §integerwl integer=2 EQUAL string=3 il 


RARER REE REKEKEKKKAKEKREKKAEKEEEKAKAKEKEKAKEKKEAKRKKKEKAKRKREREKRaHRaEE 


Use of the KEY option allows specification of a range of records 
to be printed or punched according to information within the 
records themselves (eege a sequence number). The portion of 
each record to be compared. may be specified» as welt as the 
inforration that will start and stop the cutput. 


Integer-1l specifies the column number of the subfieid to be used 
for the compare argument» and integers2 specifies the length. 
Integer-2 must be greater than zero and tess than ten. The 
compitler-name option causes automatic generation of the proper 
coluan nuaber and tength pair that corresponds to the sequence 
field of the output tisting produced by the specified compiler. 
The permissible compiler-names that can be used are BASIC» CuBdL> 
FORTRAN» MIL» NOL» RPG» SDL» OASDL and UPL. 
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The RANGE and EQUAL parameters specify the argument to which the 
subfield in each record is to be cogspared» and the action to be 


taken when a “true” coraparison is detected. The strings can be 
either an integer or an alphanumeric Literal enclosed within 
quote marks.  § When the cosparison argugents are of different 


lengths» an integer string is teft*truncated or left zero-filled 
to the same Length as the subfietds an alphanumeric titeralt is 
rightctruncated or right space"filtled to the same length as the 
subf jeid. 


[f EQUAL is specified» printing and punching wilt begin when an 
exact comparison has been made between the subfietd and string-3- 
and will continue until endeof-file is reached. 


If RANGE is specified» printing or punching witl begin when an 
exact comparison has been made between the subfietd and string-1. 
The " printing and punching continues until an exact comparison is 
made between the subfield and string-2» or until end-of-file is 
reached» whichever occurs firste 


If stringel is equal to string-2* the entire backup file will be 
searched. Every record in which the designated subfieid matches 
string 1 is printed or punched. 


Since the specified cosgparisons require an exact match between 


the string and the subfield» no sequential ordering of the backup 
fide is necessary. 


NOTE : If both the RECORD option and the KEY option are 
specified in the same statement»r —§ the comparisons 
specified by the KEY option witt be made only within the 
range of records specified by the RECORD option. 


Exanmptes: 


*PB J 125 

*PB 3 17 

*PB 4 RECORD 5 

*PB = COPIES 4 RECORD 5 

*PB 3 KEY COSOL RANGE 123 567 
*«PB 2 KEY 7 6&6 EQUAL *ABC” 

*PB 53 RECORD 1 100 DOUBLE SAVE 
*PB = LABELS 
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*PD INPUT MESSAGE (CPRINT DIRECTORY) 
Format 1) *P0 J <job number> 

2) #*PO S <session numbter> 

3) *PO <backup number > 
The *PD input message allows the satedlite system operator to 
interrogate the host system*s output file directory for fites 
entered under the usercode with which he Logged on. lf no files 


are found to match the PD as entered» the following message is 
displayed at the RSC. 


"#FILECS) NOT ON DISK" 


This sessage is aiso dispiayed if the satetlite system operator 
bypassed the iog on procedure by using the *L0O input gsessage. 
For every file that is founds the message 


"gPD = <file name> 


is displayed at the RSC and at the end of the tListing of files 
the message betow is dispilayed.. 


"#END PO*® 


Example: 


#PD J 495 
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*PH INPUT MESSAGE (CURRENT PHONE NUMBER) 


Format> *PH 


This command witt inform the operator of the current phone 
number. 


Examptie: 


ePH. | 
PHONE NUMBER IS 964-3019 


Format: *PH = <phone-number> 


This command atflows the phone nusber to be entered of changed. 
The phone number is requested when the CALLBACK option is set and 
is used for automatically re-establishing connection to a remote 
user after he has Logged off in order to transmit his output. A 
<phone“nusber> can be up to 20 characters including dashes ("77") 
for time separators (c.f. j$.NDL “PHONE = <TEXT>"). The phone 
number entered widl be echoed back for verification. 


Exaaple: 


*PH = 17805-96476881-412 | 
PHONE NUMBER IS 17605-964-6881~412 
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*QT INPUT MESSAGE CQUIT TRANSMITTING) 


Format: #QT <unit-mnemonic> <option> 


The “QT input message allows the remote operator to control 
printing and punching of backup files. The <unit“anemonic> must 
be a line printer (LP) or card punch CCP). Options can be used 
to control the output and action taken by AUTOBACKUP. A detailed 
description of these options follows: 


Cption a Function 


+ <integer> Causes RJE/ZAUTOBACKUP to skip forward the 
number of records specified by the integer 
and continue transmission of the print or 
punch file. 


- <integer> Causes RJE/AUTOBACKUP to skip backward the 
number of records specified by the integer 
and continue transmission of the print or 

punch fite.. 


COPIES - fauses RJE/AUTOBACKUP to interrogate the 
number of copies teft to te transmitted and 


displays the sessage on the resote console 
printer. 


PURGE Causes RJE/AUTOBACKUP to stop transmitting 
the current backup file and remove the backup 
file from disk. 


SINGLE Causes RJE/ AUTOBACKUP to override any 
carriage controt information in the backup 
file and replace the carriage controt 


information with a single space carriage 
control character. 


WHERE Causes RJE/AUTOBACKUP to display on the 
remote consote the © nuaber of records 
transawitted so fare 


J€ no copy of RJE/JAUTOBACKUP is active when this command is 
entered» an error message will be generated inforsning the user 
that the command is invalid in that contexte 


3725 


BURROUGHS CORPORATION | 7 COMPANY CONFIDENTIAL 


COMPUTER SYSTEMS GROUP. B1806/B81700 HOST/RJE SYSTEM 
SANTA BARBARA PLANT | - Pe Se 2219 9136 CE) 


*RB INPUT MES SAGE REMOVE REMOTE BACKUP ENTRY) 
Format 1) *RB J <job number> 

2) #RB S$ <session number> 

3) #*RB <bhackup nuaber > 
The *RB input message allows the satellite system operator to 
interrogate the host system's output file directory and remove 
entries from both the directory and the systeme If no files are 
found under the format entered or if the satetlite systen 


operator logged on via the *L@ input message» then the following 
message is displayed is the RSC. 


“@#FILE <fite name> NOT ON OISK# 


For every file that is found and removed the fottoning message is 
displayed at the RSC. 


"#FILE <file name> REMOVED" 


Exanpie: 


*RB S$ 1001 
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«RO INPUT MESSAGE CRESET OPTION) 


Format? *RO <option“name> 


The *RQO input message allows the remote operator to reset the 
options used by RJE/CONTROLLER. RJE/CONTROLLER replies with the 
verification that the option has been reset after each *kO 
message» The reply format is: 

<option *name>=6 
lf the option name specified is idflegal» RJE/CONTROLLER responds 
with: | | 


INV KEYIN. 


Refer to the docunent ation on *SO for a description of the 
<option name>. 
Example: 


*RO CALLBACK 
CALLBACK=9 
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*RS INPUT MESSAGE (REMOVE SITE BACKUP ENTRY) 


Format 1) ¢*RS J <job nusber> 
2) *RS S <session number> 


3> *RS <backup number > 


&) *RS <Cusercode)> 


The *RS input message atlows the sateilite system operator to 
interrogate the host system*s output file directory and to remove 
files from both the directory and the systere The first search 
is for the USERCODE, PASSWORD and SITE 10 of the sateilite 
Systeme When a match has been found for all three of theser the 
search wilt then be initiated for the specification entered by 
the *RS sessage. If no site id was entered at tog on by the 
satellite system operator» or if a *L0 was used to tog on» or if 
no files were found matching the parameters given» the following 
wessage is sent to the RSC.. 


“#FILECS) NOT ON DISK* 
For every file that is found and removed the message below is 
displayed at the RSC. 


"FILE <fide name> REMOVED" 


Example? 


#RS CUSER) 
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*SB INPUT MESSAGE CSITE BACKUP) 
Format 1) *SB J <job number> <option 1 Coption-21...> 

2) *SB S <session nusber> <option-1 Coption-23...> 

3) #38 <backup number> <‘optione1 Coption"2})...> 

4) *S8 <Cusercode)> <option=1 Loption7Z2}.ee> 

5) *SB = <option=1 Loption"2leee> 
The *SB input message aliows the remote operator to print or 
punch files at the satelfite systes site. This command can 
initiate the printing of any file entered under the usercode»s 
password and site~id of the resote user regardiess of which 


actual usercode created the files 


Format 1 Prints or punches alt backup files that were created 
under the specified job number. 


Format 2 Prints or punches atl backup. files that were created 
under the specified session nusber. 


Format 3 Prints or punches the backup files specified by the 
backup number. 


Format 4 Prints or punches ail backup fites created under the 
specified usercode? the parentheses are required. 


Format 5 Prints or punches all backup files created by 
RJE/CONTROLLER. 


Options: 


Various options allowed by the #S8 INPUT MESSAGE are the same as 
the *PB options. See *PB INPUT MESSAGE CPRINTER/PUNCH BACKUP), 
Sectian 3. . 
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*SD INPUT MESSAGE CPRINT SITE OIRECTORY) © 
Format 1) #50 J <job number> 

2) *SD S <session number> 

3) *S0 <backup number > 


4) *S$SD <Cusercode)> 


The *SD input message allows the satellite system operator to 
interrogate the host systes*s output file directory for files 
which were entered under the usercodes. password and site id 
specified and which match one of the above forsats. If no 
usercode or site id was entered at tog on» or if a *L0 was used 
to tog ons or if no files were found in the directory» the 
ressage below is displayed at the RSC. 


"4FILECS) NOT ON DISK" 
For every file that is found satching the specifications» the 
following message is displayed at the RSC. 


"4gSD = <file name> 


At the end of the Listing of fites» a final message is printed. 


"#END SD" 


Example: 


*SD J 512 
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*SF INPUT MESSAGE CSET FACTOR) 


Format: *SF <integer> 


The *SF input message allows the remote operator to specify the 
max nuabers of characters per transaission bicck. The initial 
default buffer size is 402 (number of characters between STX and 
ETX).- The integer must fait between 135 and 402 inclusive. 


Exanapte: 


*SF 200 
BLOCKING FACTOR=200 
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«SO padade MESSAGE CSET DPTION) 
Format: *530 <option “name> 


The «SO input message attows the remote operator to set the 
options used by RJE/CONTROLLER. RJE/CONTROLLER repties with the 
verification that the option has been set after each *SO message. 
The repty format is: 


<option"name>=1 


If the option name specified is illegal> RJE/CONTROLLER responds 
“ith 


#INV KEYIN. 


The three runctime remote terminal options are as foitlows: 


Option Function 


AUTOPRINT When this option is set» alti’ print files are 
automatically transaitted to the satellite system 
as soon as the job has been conrpteted» without 

intervention by the remote operator. 


AUTOPUNCH | “When this option is set»e all punch fites are 
automatically transmitted to the satellite system 
as soon as the job has been coapleteds without 
intervention by the remote operatore 


CALL BACK . When this option is set» and aremote user togs 
off with jobs activer connection is automatically 
reestablished urcon completion of these jobs using 
the phone number supplied by the *PH message. 
Output is then transmitted to the remote usere 
The tine is availabte for other users during the 

time between the tog off and the reconnection. 


Exanpte: 


#50 AUTOPRINT 
AUTOPRINT=1 
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*SS INPUT MESSAGE CSEND SPO MESSAGE) 


Format 1) *S$S <text> 
2) #CUSERCODE) SS «text> 


3) #<RSN>SS <text> 


The *SS input message atlows the remote operator to send consote 
printer messages to the host system orf to another satetlite 
system that is lLogged“on. Format 1 resutts in the text portion 
of the message being displayed on the host console printer. 
Format 2 results in the text portion of the sessage being 
displayed on any satetlite system console printer that 
corresponds to the given user code. Format 3 resuits in the text 
portion of the message being disphayed on the satellite system 
console printer that corresponds to the given Remote Station 
Number CRSN). 


NOTE: &SN is calculated from the USN received from NDL Handler. 
The caicutation is LSN/441. . _ 


If the sateliite system is not currently logged-ons 
RJE/CONTROLLER will respond with the following sessage:. 


#INWY KEYIN. 


Successful communication. is indicated when RJE/CONTROLLER 
responds with "#*. Hhen using format 2» the parentheses are 
required. 


Example: 


#$S WHAT TIME I5 IT 
a 

*€A) SS WHO ARE yOU 
q 

*16 SS WHO ARE YOU - 
# 
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*TF INPUT MESSAGE CTEST 8LOCKING FACTOR) 


Format: «TF 


The *TF input message allows the resote operator to interrogate 
the current setting of the blocking factore.e (See “*#SF*.) 


Exampie: 


a TF 
BLOCKING FACTOR=402 
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*TO INPUT MESSAGE CDISPLAY OPTIONS) 


SSOnunen SS 2 8B One OO QT ana enaesanqne nwmeaawe = 


Foraat 1) =*TO 


2) *T0 <option-name> 


The *#T0 input message allows the remote operator to interrogate 
the status of its remote options. Option 2 wit onty interrogate 
the status of <optionsname> [ce f- «SO 1» thus selectively 
reducing the typed output. 


Example: 


*TC 
AUTOPRINT=1 
AUTOPUNCH=0 
CALLBACK=1 


*TC CALLBACK 
CALLBACK=0 
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*US INPUT MESSAGE CUSERS ON-LINE) 


Formats *US 


The *US input message allows the renote operator to obtain a List 
of every remote sateilite system in the network by Remote Station 
Number CRSN). 


Exaapie: 


*US 


i 
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#WM INPUT MESSAGE CDISPLAY CURRENT RJE/CONTROLLER) 


Format: «Wh 


The *WM input message atlows the remote operator to request the 
compile date and time of RJE/CONTROLLER. 
Example: 


«WM 
RJE/SCONTROLLER COMPILED ON 28 JUL BD AT 1721225964 
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SYSTEM INPUT MESSAGES 


A€@i RSC input messages that are not prefixed with an "*" are sent 
to the MCP in the manner in which they are keyedtin. The MCP 
then generates appropriate responses uhich are sent to the RSC. 
Every atteragpt has been -made to make the RSC as simiflar as 
possible to the central system SPQ; however» secur ity 
restrictions have imposed certain constraints on RSC keyboard 
entriese Also» certain keyboard entries such as those which 
alter central system options or purge or clear centrat system 
peripherais have been disaitowed when entered at an R&Ce The 
legal system input messages are indicated below: 


app AP OAT) «60 AX) «6 BF) COCCHH:—«s«sCOsCiCPCCCUsCiéisCiO 


OM oP DS DY END EX FN FR FS FW GO CT HN 


HS HW It Lo LO LP Ls MH Mo MP MR MX NT 


oF aK OL OU PD PM PP PR PS PY QF QP au 


RB RE RF RM RS RX SP ST SW $Z TO Tf TS 


UL US WO WM WS WT WY 2Q 


Ail the underlined SPO commands require a vatid usercode and 
password. It is possible for a remote user tc copy or backup his 
files using SYSTEM/COPY constructss i-ee» COPY» ADD» COMPARE. 


Job related systen input messages say refer only to jobs 
initiated by the terminat where the keyboard entry is entered. 


HOST SYSTEM CONSOLE MESSAGES 


to assist the host 81800/81700 RJE cperator» RJE Hest provides 
console input and output messages. With these» the operator has 
the ability to interrogate and controt the 81806/81700 Host kKJée 


pack agee. The current Host RJE output and input messages are 
discussed in th. following sections. 
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RJE HOST SYSTEM QUIPUT ERROR MESSAGES 


The meaning of most of the host system console output messages 
displayed by RJE Host is either selfrevident or explained 
elsewhere in this document. However» some unsolicited messages 
are indicative of an error within the RJE system which way either 
require some intervention by the host system operator or inform 
the operator of some minor malfunction within the RJE Host 
SySt OMe These messages and their definitions are discussed in 
the foilowing paragraphs. 


1. "#CONTROL RECORD OUT OF RANGE.” 
Originator: RJE/AUTO BACKUP 


This message generally does not occur within a normal 
aperating environment. It indicates the receipt by 
RJE/SAUTOBACKUP of an incorrectty formatted message from 
RJE CONTROLLER. This error is not serious; the prograns 
wilt continues 


2. “#END TASK RECORD OUT OF SEQUENCE.* 
Originator: RJE/AUTOBACKUP 


This wessage should not be encountered within a normat 
operating environment. It is disptayed when RJE/AUTOBACKUP 
receives a message from RJE/CONTROLLER out of proper 
sequencee The programs will recovers howevere should this 
or any other error message be received with great frequency» 
the RJE system should be terminated Ceege» by the QT or “ST 
local SPO messages» or by <mix>DS or <aix>DP). 


3e "ZERROR OCCURRED WHILE ATTEMPTING T0 INITIALIZE USERCOCE | 
FILE.” . , 


Originator: RJE/CONTROLLER 


After executions RJE/CONTROLLER initializes the system's 
usercode/password file via a communicate with the MCP. If 
an error is encountered during this procedure» 
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5e 


6. 


RJE/CONTROLLER displays this message and terminates. The 
error must be corrected before the program can be executed 
againe 


"#FILE RECORD OUT OF SEQUENCE.” 
Originator: RJE AUTOBACKUP 


This sessage shoudd not be encountered under normal running 
conditions. It indicates that RJE/AUTOBACKUP freceived a 
eessage from RJE/CONTROLLER that was out of proper sequence. 
Alt programs will continue. No operator intervention is 
necessary unless RJE/SAUTOBACKUP generates error messages 
frequently. If this cccurs» the RJE system should be 
terminated Ceege» by the QT or ST local messages» or by 
<mix>DS or <mix>OP). 


"#F ILE "RJE/NESSAGES" NOT FOUND." 
Originator: RJE/CONTROLLER 


After execution» RJE/CONTROLLER opens a random disk fite 
named “RJE/MESSAGES" which contains ait output sessages for 
RJE/CONTROLLER. If this file cannot be founds this message 
is displayed and RJE/CONTROLLER terminates. I f 
RJE/CONTROLLER resides on a user pack instead of system 
disk» RJE/MESSAGES must also reside on the user pack. 


"#INVALIC MESSAGE RECEIVED". 


Originator: RJE/AUTOBACKUP 


As with ali other error messages from RJE/AUTOBACKUP» this 
message should not be encountered. It indicates that 


RJE/SAUTOBACKUP has received an unreccgnizable sessage from 


RJE CONTROLLER. The programs will recover. 
"RINV KEVIN. 


Originator: RJE/CONTROLLER or RJE/AUTORACKUP 


This message is disptayed by either pfrogras tr response to 
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Be 


9 


10. 


ll. 


the entry of an invalid operator input message. 


"@L0SS OF DATA SET READY ON LINE <tine number>". 


Originator: NETWORK CONTROLLER 


This message is causec ty a hardware malfunction. It 
notifies the host system operator that the data set on the 
line specified has dropped data set ready This condition 


is not fatal to the user currently tloggec on that tine as no 
output wild be tost.e Ail fides witt be saved and alt jobs 
will complete. The data set shoutd be checke before the 
user logs on againe a * 


W#MESSAGE RECEIVED FOR NON ACTIVE STATION". 
Originator: RJE/SCONTROLLER 


This message is disptayed by RJE/CONTROLLER when a message 
is received from the MCP where the session nurber of the 
gessage does not match any session nusater currently active 
in the systenr. The message is discarded and RJE/CONTROLLER 
continues. 7 . . 


"#PACK <pack name> REQUIRED FOR USER <Cusercode)>» SN 
<RSN>". | 


Originator: RJE/CONTROLLER 


Fottowing the successful log on of a user whose usercode 
requires a packs this message is displayed at the host 
system. The host systes operator should converse with the 
remote satellite system operator to determine if the pack 
named should be loaded on the systesn- If it is decided to 
use system disk instead of the user pack» an OV should be 
entered at the host system. This overrides the pack request 
and sends att jobs to system disk. If a job is entered 
before the user pack is on line or the OV entered» that job 
will go to system disk automaticaily. 


"#P8 OR SB INVALID SYNTAX" 


Originator: RJE/AUTO BACKUP 
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12. 


13. 


This message is displayec by RJEZAUTOBACKUP when an RT tocal 
input message entered by RJE/CONTROLLER contains erroneous 
texte When this error occurse no files are transmitted to 
the remote satellite system. The host system operator 
should correct and reenter the messages 


"#RECORD RECELVED FOR NON ACTIVE JoBn 


Griginator: RJE/CONTRULLER 


RJE/CONTROLLER receives MCP wessages which reference both 


users and jobs. If a message is received where the user 
referenced is active but the job specified is not currently 
running under that users this wessage is dispiayede The MCP 
gpessage is discarded and RJE/CONTROLLER continues. 


"#RETRIES UP ON LINE <tine number>” 
“Qriginator: NETWORK CONTROLLER 


This message is dispiayed by the Network Centroller when the 
message it is trying to send on the line specified is not 
being acknowledged and the retry count is exhausted. The 
host systes operator may Let the Network Controlter continue 
to send to the remote satellite systes or it may instruct 
the Network Controtter to discard the message via an #E 
local input message. 
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i4, “#TASK RECORD OUT OF SEQUENCE* 


15. 


16. 


Originators RJE/AUTUBACKUP 


This wessage should not be encountered under normat running 


conditions. It indicates that the message received by 
RJE/AUTO BACKUP from RJE/SCONTROLLER is out of proper 
sequencee The programs witt continue to rune No operator 


intervention is necessary unless this message is frequently 
disptayed. 
"#USER RECORD OUT OF SEQUENCE* 


Originators RJE/AUTO BACKUP 


This is another of the R JE/AUTOBACKUP Ressages which shouid 


not be encountered in a normal running environment. Lt 
indicates that RJE/CONTROLLER has sent RJE/SAUTOSACKUP a 
message which is out of proper secuence. The progrars 


continue and the operator shoutd interwene only if this or 
some other RJE/AUTOBACKUP message is frequent enough to 
warrant terminating the RJE system Cesces by the OT or “ST 
focai SPO messages» or by <mix>DS or <#ix>DP). 


“#WARNINGS OLRECTORY NEARLY FULL™ 


Griginator: RJE/CONTROLLER 


The output file directory used by the RJE/CONTROLLER is a. 
large disk file €10-000 records) which» under even the most 
extreme conditions» should never be fillede Should the file 
ever be nearty fudl Cless than 50 records remaining)» then 
the above message is displayed whenever a record is added to 


the file. If this situation occurs» the directory should ce 


purged of entries which are not needed. 
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17. “#WARNING: WORKFILE NEARLY FULL” 


16. 


19. 
20. 


2le 


Originator: RJE/CONTROLLER 


The workfite used by the RJE/CONTROLLER is a Large disk fite 


~€102000 records) uhich» under even the. most extreme 


conditionss should never be filled. If the file is close to 
being filled» then the above message wilt be displayed 
whenever arecord is added to the file. If this situation 
occurs» active users should be logged off untii the workfite 
stabilizes with the coapletion of their remote jobs. 


“WARNING: CONTROL CARD FIELD TRUNCATION” 


Originator: RJE/CONTROLLER 


Columns 73789 of the controt cards from a remote station are 
blacked out» comments Cstarting with *2") are rewoved anda 
trailing blanks are ignored. The rewnaining data is then 


packed into a 2600 byte areas If this 2000 byte area is 


filled aif further control inforration is ignored anda 
RJE/CONTROLLER sends the above message to the remote 
station. . 


"#INVALIO LSN FROM STATION STATUS" 

"#ILLEGAL TERMINAL TYPE" 

"BINCONSISTENCY GETHEEN LSN*S OF RSN 

These three wsessages (19» 2G» and 21) are originated by 


RJE/CONTROLLER and indicate possible hardware ealfunction. 


An automatic DUMP jis produced tc assist in locating the 
problen. ) 
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RJE HOST SYSTEM QPERATOR INPUT NESSAGES 


The host system operator may interroaqate and control 
RJE/CONTROLLER via host system input messagese These messages 
are free form with no embedded blanks altowed within tokens. 
They are defined by a unique two character anemecnic which must be 
the first noncbtlank series of characters in the messagee 


RJE/CONTROLLER always acknowledges host system input messages. 
If the message was entered correctiy» a pound sign "4" wilt be 
disptiayed or a detailed response to the command. If an invalid 
message is entered the following ts displayed. 


"#INV KEYIN"™ 


The current RJE host input messages are discussed in the 
following section. 
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AP HOST SYSTEM INPUT MESSAGE CAUTOPRINTS RUNNING) 


Format: AP <number> 
ap 


The AP input message permits the host systems cperator to control 
the nusber of copies of. RJEZAUTOBACKUP which may run 
simutitaneoustly. The number supplied must te between 1 and IE 
inclusive. If the number entered is greater than the current 
settings RJE/CONTROLLER wilt search for a user which sight need a 
copy of RJE/AUTOBACKUP and execute a copy for that user. 
RJE/CONTROLLER witl respond with the following ressage. 


“#NUMBER OF COPIES SET TO "<number>” 


If no number is supplied», RJE/CONTROLLER wilt display the current 
number of autoprints which may run at one time. 


Example: 


AP 5 
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OV HOST SYSTE® INPUT MESSAGE (OVERRIDE PACK) 


Format: OV <RSN> 


Fotlowing the successful log on of a resote user who requires a 
pack or cartridge not currentty on tines the following message is 
disptayed at both the RSC and the host system SPO. 


"APACK <pack name> REQUIRED FOR USER <Cusercode)>» RSN <RSN>* 


Should it not be convenient or desirable to put the user pack on 


line» the host system operator may enter an CV message. This 
witl force alt jobs for that user to run on systes disk. If a 
job requiring an absent pack is executed» the MCP will 


automatically send that job to system disks. If the hast system 
cperator overrides the pack request» the following message is 
sent to the RSC. 


"#PACK REQUESTED HAS BEEN OVERRIDEN TO SYSTEM DISK" 4, 
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CT HOST SYSTEP INPUT MESSAGE (QUIT RUNNING) 


Format: QT 


This input message attlows the host syste#r cperator to halt the 


RJE syster in an orderly manner. ALL remote satettite systems 
which are logged on but have no active jebs and are receiving no 
output witl immediately be logged off. Atl other users will 


continue until the current output task has been coapheted. These 
users will then be togged off. Att remcte jcbs wilt be allowed 
to complete before RJE/CONTROLLER goes to ENJ. 


The QT message must ce entered twicee After the first entry» the 
following message is displayed. 
“#PLEASE RE-ENTER "QT" MESSAGE” 


The actual aT begins after the operator enters the second QT. 


Example: 


QT 
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RE HOST SYSTEM INPUT MESSAGE CRETRY) 


Format: RE <line #> 


This input message is directed to the Network Controller. If the 
Network Controlier exhausts the retry count for a message on a 
certain Liner it will disptay the foilowing message. . 


"#RETRIES UP ON LINE <line nunber>" 
The Network Controlter continues to trans#it the message untit 
the host system operator enters “RE <tine #> ™" to RJE/CONTROLLER. 
RJE/CONTROLLER queues a message for the Network Controtter 
causing it to discard the message when retries are up. 


Example: 


RE 1 
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RT HOSTS SYSTEM INPUT MESSAGE CROUTE FILE) 


Format 1) RY ALL <fite name> {(C<text>]) 
2) RT <RSN> <file name> U<text>] 


3) RT <Cusercode)> <file naze> (<text>?] 


The RT input message at lows the host system operator to route 
backup files to specific rewote satellite systems. The ALL" 
format wilt route a copy of the specified fite to every user 
currentty Logged one The <RSN> format will route the file to the 
RSN specified if a valid user is togged on at that RSN. The 
<Cusercode)> format wilt cause the host system to send the file 
to ail users logged on under the given usercode. 


To send a files a copy of RJE/AUTOBACKUP must be availatte for 
every user or RJE/CONTROLLER witl try to schedute a copy of 
RJE/AUTOBACKUP for the user and display the following message. . 


W"#PLEASE RE-ENTER "RT" MESSAGE FOR RSN *"<RSN>* AT A LATER TIME" 
The file name entered must ‘conform to RJE backup fite naming 
conventions for the message te be valid. An example is shown? 

{<pack id>J/<multi-file-iar>/cre" or “Z%"><backup number> 


The <multi-filetid> need not be a usercode» but may be any 
character field of ten characters or tess. 


The fite witt always be saved at the host system regardless of 
the format used to enter the message. The text field in the 
above formats is identical to the text field in the "*PB8" and 
"458" remote input messagese If a copy of RJE/AUTOBACKUP is 
available» the RT wilt be queued for the remote satellite systen 
user and the following wessage sent the the user*s RSC. 


“#P8 SCHEDULED BY LOCAL OPERATOR" 
Exaaple: 


RT CUSERA) PACK/CUSERA)/#645 COPIES 2 SINGLE 
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RY HOST SYSTEM INPUT MESSAGE CREADY LINE) 


Format? RY <RSN> 


The command causes the RJE system to ready the RSN specified in 
the statement. The command negates the action cf the SV message. 


Exampte: 


RY 1 
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SE HOST SYSTEMS INPUT MESSAGE CSET LOCAL LOG ON OPTION) 


Format: SE 


The SE input message will cause a wessage ta be displayed at the 
host system console whenever a new user logs on or off the 
System@e 


"#USERCODE “<usercode>™ LOGGED GN AT RSN "<RSN>">» 
SESSION "“<session>” 


"#USERCODE *<usercode>" LOGGED OFF AT RSN -"<RSN>%,. 
SESSION "<session>” 


W#USERCODE *"<usercode>"» RSN "<RSN>"%» SESSION "“<session>*» 
LOGGED. OFF JO8S ACTIVE" 


This option. is either set or reset when SE is entered» depending 
on the current setting of the option within RJE/CONTROLLER. This 
option may be set permanently by modifying SW1 to a non-zero 
value or by setting “SWI=1" either at execution time or whenever 
RJE/CONTROLLER is executed. The SE command aay stilt be used as 
usual. 


Example: 


SE 
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SS HOST SYSTEM INPUT MESSAGE CSEND SPO MESSAGE) 
Format 1) SS <text> 
2) <Cusercode)> SS <text> 


3) <RSN> SS <text> 


The SS input message is used to route messages from the host 
systema console to the remote RSC. Format i wilt route the text 
of the message to alt users which are currently logged on. 
Format 2 will route the message to all users currently logged on 
under the specified usercodee The third format with onty route 
the message to the user at the specified ASN. 


Exanple: 


CUSERA) SS HELLO FROM SPO 
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ST HOST SYSTEM INPUT MESSAGE (STOP RUNNING) 


Format: ST 


The ST host system input message will bring the entire RJE system 
to an immediate halt. Alt crograms running at the time will hatt 
and all output will be Tost. ee ee re ee 
gee Serene peepee NDS ar SATANIC 


The ST message must be entered twicee The systen responds to the 
first entry with this message: 

"#PLEASE RE-ENTER "ST" MESSAGE” 
The actual ST begins only after the second consecutive 5ST is 
enterede . 
Example: 


3T 
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SV HOST SYSTEM INPUT MESSAGE CSAVE RSN) 


Format: SV <RSN> 


The SV message allows the host system operator to save the RSN 
specifieds Ci.see» to tog off the current user). The command is 
valid any if the RSN is active. Ait jots wild complete and att 
output will be saved. This message has the same effect as a 
“BYE™ entered frog the user's RSC. 


Exanple: 


SV 1 
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WH HOST SYSTEM INPUT MESSAGE (WHERE ARE USERS) 
Format 1) WH 
2) WH <RSN> 

With this message» the host system operator can obtain a List of 
every remote satellite system in the network by usercode = and 
remote station number CRSN). If the first format is usede the 
following message is displayed for every user currently logged 
One 

"#USERCODE "<Cusercode)>" AT RSN <RSN>" 
When the second format is used» the above message is disptayed 
only for the active user currently togged on at that RSN. If no 


users are founds RJE/CONTROLLER displays the following: 


“@N0 USERS LOGGED ON™ 


Exampies 


WH 
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WM HOST SYSTEM INPUT MESSAGE CDOISPLAY CURRENT RJE/CONTROLLER) 


Foraat: WM 


The WM wessage atlows the host systes operator to request the 
compile date and time of RJE/CONTROLLER. The response is shown 
below: 


"RJE/CONTROLLER COMPILED ON <date> AT <tine>” 


Example: 


WM 
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RIJEZAUTOBACKUP HOST SYSTEM QPERATOR INPUT FESSAGES 


The. fottowing two messages may he entered to RJE/AUTCBACKUP. If 
an invalid wsessage is received by RJE/AUTOBACKUP» the response is 
as shown below: . 


—WHING KEYIN® 
STATUS HOST SYSTEM INPUT MESSAGE 
Format: STATUS 


This messages allows the host system operator to request the 
current status of RJE/AUTOBACKUP. It witd respond with the 
following: 


"#USERCODE = <usercode>" 
“#RSN = <RSN>* 

"$LSN = <LSN>* . 
"SSESSION = <session>” 


pees 
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STQP HOST SYSTEN INPUT MESSAGE 


Format: STOP 


The purpose of this message is to halt RJE/AUTOBACKUP. It must 
be entered twice to achieve this. The first entry causes this 
response from RJE/AUTOBACKUP. 


“SPLEASE RE-ENTER "STOP" MESSAGE" 


Following the revwentry of the STOP messages RJEZAUTCBACKUP will 
terminates 
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RJEA SYSTEM CONTROL MESSAGES 


In addition to the standard datacoms control interfaces systems 
in an RJE environment need to communicate certain information via 
system messages to insure orderly operatican. Syster control 
messages are sent only to the first of the four stations declared 
for every remote user. The station address equals "05" (See 
Network Controtter documentation below). These wessages are sent 
without operator intervention by the systems themselves. They 
are not obvious to the operator (Cie@er they do not appear as a 
SPO message at the host system or the remote satellite system). 


RJE system control messages are two cheracter decimal codes» 
sometimes followed by additionat data. | 


CODE DEF INITION | EXPLANATION 


= 2-2 = Em me Be ea ; @2 ea eo @eneeamaedqua = 


01 Logged on Sent by the host syste operator to 
| the remote user to inforge hia that his 
terminal has been Logged on and that 
the host system wilt now accept useg 

messages and input data.» 


O2dddd Buffer size Sent fros either system», requesting a 
change in the length of messages being 
assegbied for transmisstone “dddd" is 
a varigble length field (3 characters 
minimum) containing the requested 
message length in decimal notation. 


03 Logged off Sent from the host system to the rem 
note terminat to indicate that the 
terminal is no Longer togged one Oper” 
ator messages and input data wilt no 

donger be accepted. 


Q4dddd Buffer size reply Sent from either system as a repty to 
Buffer size request (C2) sessagee 
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gudan( ohtes 


Device not ready Sent from either system instructing 
Suspend the other to suspend transmitting 
. messages for DAL and DA2- Indicates a 
tenporary condition at a devices such 

as a tine printer cut of paper. 


= PO 
Nw 2 S&S 


06 Device not ready Sent fron either system informing the 


Abort ether that an uncorrectabte condition 
exists preventing the processing of 
additional transwissions for DAL» DA2. 


= SS 
N > 3 


07 


0 Device Ready Sent frow either system: 1. After a 

A device not ready (065 or 06) system 

2 | | message to indicate that the candition 
has been corrected and the device is 
again reaay to receive data» 2.2 When- 
ever a formerly unavailable device 
becomes ready to receive data. 
32 Ymmediately after a togged on (31) 
system message to indicate each device 
that is ready and avaitable to receive 
data. . 


— PO 


D OD Cutput complete Sent from the host system informing 
A A ’. the remote terminal that ail current 
1 2 output from the jot to the device is 
complete. AS response by the remote 
terminal to the host system is not 
required. 


O9ddss5s ati - id Sent from the remote terwrinat to the 

host system prior to being logged on 
to provide the host with a positive 
‘geans of identification independent of 
any security functione 
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The following chart of systems messages cepicts the requirements 
for implementation of these message for both the host system the 
the remote satetlite system. 


HOST SYSTEM TERMINAL SYSTEM 


MESSAGE wen enene--- een ennnnn n-ne 
CODE RECV SEND — RECV SEND 
a1 NOT REQUIRED MANDATORY MANDATORY NOT REQUIRED 
02 MANDATORY = MANDATORY MANDATORY OPTIONAL 
03 NOT REQUIRED MANDATORY MANDATORY NOT REQUIRED 
04 MANDATORY MANDATORY MANDATORY MANDATORY 
05-97 MANDATORY OPTIONAL MANDATORY OPTIONAL 
08 OPT [ONAL MANDATORY MANDATORY OPTIONAL 
09 OPTIONAL NOT REQUIRED NOT REQUIRED OPTIONAL 


4-1 
BURROUGHS CORPORATION COMPANY CONFIDENTIAL 


COMPUTER SYSTEMS GROUP B1800/81700 HOST/RJE SYSTEM 


SANTA BARBARA PLANT Pe. Se 2219 O136 CE) 


BL8GO7B1790 HOST RIE IMPLEMENTATION 
RYE CONTROLLER 
GENERAL PESCRIPTION 


The RJE Controller is a general purpose BI8990/81709 program which 
handles the interface hetween the 81800/81700 remote user and the 
BiBO0O/B1700 KCP. The RJE Controlter runs with a general though 
properly configured Network Controlfer. Each tine may have onty 
one remote  satettite system (since B8urrcughs RJE is a 
point-to-point discipline). Each remote satellite is represented 
as four stations in the NDL station section. The four stations 
correspond to the SPO» reader/punch» printer and a station for 
control messages. For further infersation on NOL generation 
refer to the section on "GENERATING THE NETWORK CONTAOLLER*. 


QPERATION 
LOG ON. 


The network controlter notifies the RJE Controller whenever a new 
user enters the system (this is done whenever a new user has 
established a new connecticn by the exchange of an ENQ-ACK 
sequence on the line) or whenever a current user revestablishes 
his connection with the host. The RIJESCONTROLLER witt send 
messages for the particular remote satellite syster identifying 
the host system and requesting the user to enter his usercode and 
password. (See section titted "LOG ON AND LOG OFF MESSAGES"). 


LOG ON is not mandatory. If an "*10" is sent from the remote SPO 
following the LOG ON request then the user will be connected 
without requiring a usercode or passworde An “*LO" requires that 
a valid usercode be supplied with every program executed from the 
remote satellite systeme The format of the usercode controt cara 
placed at the start of each deck or execute SPO message is “7USER 
XXX/ZZZ"™) or "US XXX/YYY"™. Regardless of the sethod of togging?» 
after a user ic Logged on» a session numter is assigned to the 
user and a message with this sesston nurber is sent to its RSC. 
This session number identifies the user and all jobs sent to the 
host and backup files created by the user white Logged on. 
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If a user wishes to suppty a remote site ID te the host» it aust 
be sent either just prior to or just after being logged on at the 
host system. (See *I1D REMOTE INPUT MESSAGE). It wit be 
discarded if sent at any other time. Until aoaeoeuser has 
successfully logged on» any card input from the remote reader 
will be discarded. Also» if a remote user were to revestablish 
his connection with the hosts he wills in effect» log himself 
offe and must re“LOG ON. If the same usercode and password are 
supplied as before» the same session number wilt be assigned. 


PROGRAM ENTRY 


Once togged on» a user may enter or run a job at any time Cunless 
the host has sent a message to the remote satellite system 
disabling or suspending its card reader). ALi incowing decks 
must start with control cards and the input stream wilt be 
flushed untit a control card is found. Ait the controt cards for 
a job wii be stripped off the incoring strea# to be passed ta 


the MCP via aé# zip conaunicate. The communicate will be done 
jemediately after alt the control cards fer the job have been 
received. The RJE/CONTROLLER places usercode» session numter >» 
and queue information in the zip communicate. The MCP will 
respond through a speciat queue and supply jok numbers and 
usercodes of all jobs scheduled by the communicate. The name of 


the input card file is also returned by the MCP. 


A remote card deck can have only a IG character file name. Names 
of the form A4/B are not allowed. The RJEZCONTROLLER wilt change 
the names of incoming card files to a standard forsrat which will 
identify the disk file as a remote card decke The standard deck 
name format wilt use the user suprlied file name as the file-ID 
and use a standard name for Multi*File-1I0 in which the job number 
of the particular job has been embedded. When an “?END" control 
card or ae controt card starting another job is. scanneds 
RJE/CONTROLLER witt close and tock the data file or files entered 
for that job and dispatch the job by zipping a speciat command to 
the MCP which witl force the job out of the waiting schedule and 
attach the session number of the user which created the job to 
it. Thuse the job witt be processed onty after all the data 
decks for the job have been spooled to disk. With this final 
communicates the BL1800/B1700 MCP ts then in centrol caf the job. 
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It is possibile to enter jobs under a usercode which is different 
from the one under which the remote operator togged~on- The 
control card “?USER ™ or *2U5 * fottowed by one*s usercode and 
password (Cieee» “"PUSER ABC/XVYZ") as the first card in the deck 
wilt override the remote site*s usercode for that one program 
only. The usercode and password entered this way wilt be 
verified and must therefore be valid or the job stream will te 
discarded and an error message sent to the reaote site. 


A ?7END or a ?DATA control card must be included in a string of 
control cards before the cards are zipped to the MCP by RJES 
CONTRCLLER. If a job is to be executed from a remote card reader 
which does not have any remote card decks Cand therefore no ?7DA4TA 
control cards) associated with it» then a ?END controt card 1s 
necessary for that job to be zipped when the string is received. 


A resote card deck entered by the remote which is not associated 
with a job {control cards for the job having been entered 
iamediatety prior to the ?D4T4 control card for the deck) wilt be 
spooled as a disk file at the host systene 


A usercode control card immediatety preceding the ?70ATA control 
card wiil cause the disk fite to be naned under the usercode 
supplied by the US control card. 


Multipie data decks are also = passible. If instead of 
encountering a ?END controt card another ?DATA control card is 
seens the next deck wilt atso be spooted to disk and named 
according to the same usercode as the previous decke 


CNOTE: Multipte data decks are reaity to enable a user to spool 
a number of decks to the host systen under a usercode different 
from that used by the remote operator to log ons although it is 
permissible tc do so with the defauit usercode). 


PROGRAM EXECUTION 


RJEZCONTROLLER will be notified via a special message from the 
MCP when a remote program entered through RJE/SCONTROLLER has 
either gone to a0J» gone to EQJ» or closed an output backup filee 
Upon B80J of a remote job» RJE/CONTROLLER wilt upgrade the entry 
for that job in its active job file to show it as executinge 
Upon E0OJ» in addition to changing the entry for that jot in its 
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active job file to indicate that its output is waiting to ce 


transeitted to the remote site» the controtter will afiso send a 
zip to the MCP to remove ait remote card decks which may have 
teen entered for that job. 


When notification of a backup file is received by RJE/CONTROLLER, 


an entry for that file is made in its cutput*file. After a 
program goes to E0J» att backup files created oy the program are 
queued for output if the autoprint option has heen set. If 


required» a copy of a program nameaq RJE/AUTOBACKUP is executed» 
RJEZAUTOBACKUP wilt then transmit the fite to the remote 
satellite system and notify RJE/CONTROLLER when it is donee 


The remote user wilt be able to control his jobs just as if he 
were at the 81800/81700 SPU. Ali relevant messages concerning 
his jobs which would normally appear on the BlL800/81705 console 
wiil also appear on his remote console and tikewise any messages 
sent from his remote SPO concerning his jobs will be passed to 
the MCP. Aili communication between RJE/CONTROLLER and the MCP in 
regards to messages to and from# ae resote consote will have 
session number and usercode included so that the MCP wilt know 
the originator of the messages and RJE/CONTROLLER witl know the 
finatl destination of the messages. 


If a user has the autoprint and autopunch options set for his 
remote site (the defaudit value for these options wit be true ana 
false» respectively)» atl print and punch output from any job 
will be automatically sent to the remote terminat in the order in 
which the backup files were opened. A user say have any number 
of jobs running at a given time» all of which may be creating any 
number of backup files. In order to maintain the correct logical 
order of these files» output for a given jceb created under a 
particular usercodes session numbers» and job number wilt not te 
transrwitted to the remote site until that job has gone to EOJ. 
If the autoprint option is set» adi output for a job that has 
gone to EQJ will be transmitted to the remote site in the order 
in which the files were created (Ctowest backup file number 


first). Qnty when att output for ai given job has been 
transmitted wilt the entry for that job he deleted from the 
active job file. If the autoprint option is not sete that jab 


HiAl cemain in TJE/CONTROLLER*s active job file untit the user 
fags off. At this time» the host system wilt delete alt entries 
for the jobe 
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QUTPUT RETRIEVAL 


When a user logs one att backure fites which were created under a 
previous session number witd not be automaticatily sent to the 
remote usere but must be expticitiy requested. In order to 
accomplish these requests» tocat commands have been imptemented 
in RJE/CONTROLLER to enable users to deterrine the names of 
backup files» and to have them transmitted in any sequence. It 
is possibile to request files by session nusnber» job number» 
usercode» or backup file nusbter. 


If a backup file is created under a certain usercodeée»s then that 
user way tog on from any resgote satellite systes and cihaim att 
the output created under that usercode. A number of jobs may ve 
entered from one site under different usercodes. The operator at 
the remote satellite system may request ail the backup fites 
created by these program to be transmitted to the remote 
sateliite system» as long as the usercode» password and resrote 
satetlite system ID of the operator match those under which the 
system was logged on. 


CALLBACK 


In order to obtain a more efficient utilization of a remote 
terminal and its datacomm Line» the autowatic caitback feature 
has been implemented for VII.0. A remote user togs cff with the 
callback option set before his job(s) have been completed. The 
remote tersinal is then made available for other users. Upon 
completion of the originat user*s jobs» RJE/CONTROLLER will find 
an available dialout line and automatically revestablish 
connection with him at the phone nuaber crevicusty suppliede His 
output wilt then be sent to him autoraticatly without any 
operator intervention. 


JOR SUMMARY INFORMATION 


Job summary fides have been implemented. For any resote programs 
a job sumaary file is a print file of ail SPO messages ana 
control cards sent and received by RJE/CONTROLLER for that jot. 
Untit that job goes to E0J» adi these wessages are stored in 
RJE/CONTROLLER*s job summary file as a list (the initial entry is 
pointed to by the entry for that job in RJE/CCNTROLLER*s active 
job file). Upon E0J of the job» if the autoprint option is set» 
this print file will be transmitted as the first file for that 
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job. If the autoprint option is not set» then upon E0J» the 


controiter witt dunap alt the job sussgary information for that job 
to a unique disk file and an entry for that file will be made in 
RJE/CONTROLLER*s output-fite. This disk file wilt then te 
treated as any other backup file and may be accessed by = any 
RJE/CONTROLLER command which would normally access backup files 
listed in RJE/CONTROLLER*s output*file. 


BURROUGHS RJEA DESIGN CONSIDERATIONS 


The initiat release of RJE/CONTROLLER fully supports the 
Burroughs RJEA RJE system. This incdudes atl nine tocal systen 
controd messages (Cstation address “99> fwessage types "C1" 
through 799%» which give the user the ability to control 
peripherals and change transmission buffer size). See Burroughs 
RJEA specifications for a detaited explanation. The 
RJE/CONTROLLER supports card and SPO input onty and anty SPQ>, 
printer and punch outpute 
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PROGRAM STRUCTURE 
EXTERNAL PERMANENT EILES 
BJE QUTPUT“FILE FILE 


Whenever RJE/CONTROLLER receives notification of the creation of 
a backup fite for a remote user» an entry describing the file is 
aade into this file. When a backup file has been transmitted to 
the remote sites the entry for this file wilt be deleted from the 
OUTPUT“FILE. Through this file» the remote user may claim output 
when the files were not initially sent to the remote site cut 
retained at the host system. Each entry in the OUTPUT-FILE file 
wilt have five fields. 


BACKUP FILE NUMBER 

JOB NUMBER WHICH CREATED THE FILE 

SESSION NUMBER UNDER WHICH THE FILE WAS CREATED 
USERCODE WHICH CREATED THE FILE | 
USERCODE» PASSWORD» AND SITE [0 AT INITIAL LOG ON 


When a user logs back on the host systems he may request his 
backup files under any of the above entries» In this way» a user 
may tog on from a site and enter a job or jobs and then he or 
another user with the same usercode may log on from a different 
site at a fdater time and claiw att output created under that 
usercodee Output may be claimed by job number or session number 
as Long as usercodes match. for targe shop operations» when a 
dtarge number of jobs may be entered at one tige under a number of 
different usercodes» output may be claimed via the last field in 
this file. If one’s usercode» password» and site ID match those 
in the tast field» then he may clais ali output for that site 
regarctess of which usercode created the fite. 
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EXTERNAL TEMPORARY FILES 
ACTIVE JOB FILE 


All jobs initiated by RJE/CONTROLLER are stored in this file 
under job number» usercoder and session numbere This aids the 
controller in message routing and in allowing the remote user to 
control jobs running under his usercode when he togs back on the 
host system with jobs stilt running under his usercode. 


QUIPUT CARD EILES 


One output file for each of sixteen users is maintained. By 
manipulation of these files» alt incoming card files from the 
remote sites are formed into logicatiy separate data files on the 
host system. 


INPUTZOUTPUT REMOTE FILE 


Only one remote fite is dectared in RJE/CONTROLLER for 


communication with the network controtiter. Qne queue exists for 
each station in the network controttler. Each Line Cand therefore 
each user) will have four stations. | These quetes will be for 


communication between the network cortrotler and RJE/CONTROLLER. 
MCP QUEUE FILE 


One queue is specified for the reception of SPO messages from the 
MCP destined for the remote user. The session number specified 
in the message from the MCP will indicate the final destination 
of the message. 


MCP RESPONSE QUEUE 


A queue is used for communication of the resuits of zips done by 
RJE/CONTROLLER. The name of the queue will be passed in the zip 
and the MCP will place the results of the communicate in this 
queue inmediately after the communicate. 
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JOB SUMMARY FILE 


The controiter forms a job summary file of att SPO wessages and 
control cards sent and received for any remote frograr. Until a 
job has gone to EQJ» atl messages for that jobe and att other 
remote jobse which are to tbe printed in their jot summary fite 
will be stored in this disk file as lists. The start of a tist 
for a particutar job is stored in the entry for that job in 
RJE/CONTROLLER*s active job file. ; 


REMOTE USER sis1u(EIKe ) 


The status of each user is maintained in this table. Tt witt 
s es ite @ : eer . 

include in addition to the usercode» passwords and site ID» the 
status of the peripherals at the remote site» the current 


settings of the options under which the user is running and the 
current state of his session within the host system. 
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ANTERNAL TABLES 
L2NZSESSION NUMBER TALE 


All users are identified in the MCP by their usercode and session 
numbere Since the network controller is governed by LSN» the LSN 
table in maintained so that messages may te routed properly. 


RJEZ AUTOBACKUP TABLE 


The status of each of the RJE/AUTOBACKUP progrars which may te 
running at one time is maintained in this table.» Status includes 
which user the program is currently servicinge the file it is 
sendings and the remote file nuster cf the remote file of the 
RJE/AUTOSACKUP program. | : . 
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RJE AUTOBACKUP 


The trans#ission of backup files is done by RJE/AUTOBACKUP. 
RJE/CONTROLLER has direct control over the executions anda 
terminations of this program. 


As the need arises» RJE/CONTRULLER zip executes a copy of 
RJE/AUTOBACKUP. RJEZAUTOBACKUP opens a renote file belonging to 
the coantrottler. The open will be passed te the controtler § for 
approval. The resident code option for the file should be set to 
disk. To determine the name and destination of the next backup 
file>» RJE/AUTOBACKUP will issue a read of its remote file. 
RJE/CONTROLLER has three options available at this tise. 


ie Let the crogran wait Crotfled out to disk) by taking no 

OS actione This saves 805 time wher output becomes ready to 
sende 

Ze Send this copy of RJE/SUTOBACKUP to EDJ. 

Se Tetl it what file and where to send ite 


These options are also available to the hast operator through 
communication with RJE/CONTROLLER. 


JOB SPAWNING AND CONTROL 
The ability to spawn anc control jots is essential for 
inplerenting host RJE. RJE/CONTRGLLER receives jobs submitted 
from remote terminals. It then executes and controls these 


programse |The MCP extensions required to do this function are 
descritved in this sectione _ 
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GENERAL QVERVIEY 


Job spawning can be generality defined as the ability to 
programmaticatly execute jobs and maintain an adequate level of 
controt over these jobs during their execution. The ability to 
execute jobs has been present for some tiwe in the WMCP via the 
"ZIP" command, however» the ability to control a job which had 
been "ZIP" executed has not existed until nowe The mechanism 


developed to spawn and controt jobs in the MCP can be broken down 
into several distinct areas. 


1. Extensions to the "ZIP" function to fropogate control 
information when a “spawned” job spawns another job. 


Ze New controt card commands to associate the necessary control 
information with “spawned” jobs. 


36 Specific changes in the generat MCP functioning to recognize 
and aoptly the control information to such areas as job 
scheduling» message routings file naninge etce 


The mechanism has been designed to give the user some flexibility 
in setecting the Levelt of controt he may desire over a “spawned” 


job. The user may select a mode of cperation where he is only 
informed of the birth» deaths and status changes cf a “spawned” 
jobs or he may select a mode where the controlling joc 


essentially becomes the “spawned” job*s &PG and receives alt 
communication normally associated with the locat SPO. 
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SUCUE COMMAND 


Syntax: QUEUE <namel> £/ <name2>] 


Oescription: 


The QUEUE command allows the user to designate a previousty 
opemed queue file as a control queuee The cortrol caqueue provides 
a mechanism whereby the MCP can comgunicate to a controlling job 
on behatf of a spawned job» or in response to other control card 
commands which the controlling job way wish to receive. For 
examples the control string "QU X/Y EX DMPALL™ will cause the MCP 
to insert into queue X/Y the following messages: | 


ae A speciat schedule record message. 

be A special 80J/ message. 

“ Any status change messages throughout the jot*s tife. 
de And» eventually» a special EOJ messaqgee 


‘The format of these messages is explained in a tater section. 
The QU command may giso be used to obtain MCP responses to normal 
SPB tnput messagese For exampte» the string "QU X/Y WY" would 


cause the standard output from the WY cosmand to appear in queue 
X/Y~ 


The underscore under QU inpties that only the first two 


characters are necessary (CeéeGe»s QU and QUEUE are both valida 
syntax). . 


4-14 


BURROUGHS CORPORATION COMPANY CONFIDENTIAL 
COMPUTER SYSTEMS GROUP B1800/81790 HOST/RIJE SYSTEM 
SANTA BARBARA PLANT | P. Se 2219 9136 (FE) 
LOG SPQ COMMAND 


Syntax: LS 


Description: 


The LS command causes a bootean to be set and carried with a 
control string and eventuatly a job. The function of the LS 
boolean is to cause alt control messages (both input and output) 
to he inserted in the controt aueue Cnote: a @U command is 
required in the control string prior to the LS command). £[n 
addition» the LS bootean has the effect of bypassing the locat 
SPO except for error messages which . require operator 
intervention» or if the RASG option in the MCP is set. For 
exampler the control string "QU X/Y LS EX DMPALL™ would cause the 
following messages to be inserted into the control aueue X/Y:? 


ae The special schedule record message. 
be A message containing the actual control string. 
Ce The special BOJ message. 


de The actual SPO 80J message. | 

Ce The normal OMP ALL display to the SPQ. 

f. The ACCEPT message from OMPALL. 

ge Any input to OMPALL» and subsequert ACCEPTs fros OMPALL. 
he Any status change message throughout the job's life. 

ie The special E0QJ message. 

j- The actuat SPO EQJ message. 


NOTE A job which has been spawned and has its LS boolean set 
| fay not spawn a job with the LS conmancde 
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ZIP QSYEVE COMMAND 
Synt ax: za <namel> {/<name2> 1 
Description: 


The Z2@ command is simitiar to the QUEUE command with the exception 
that the queue specified is used exclusively for schedule 
messages and data card messagese Where the controt queue may 
contain many messages concerning jots» MCP responses to SPU 
commands» etce» the zip queue will onty contain schedute recorcs 
of jobs zip executed by the controlling program» and the data 
card fabel message if a DATA control card was encountered in the 
zip string. 


This effectively allows the controlling program to be immediately 
aware of the fact that a job has been scheduted without having to 
scan through the general control queue for pertinent messages. 
In generals the control queue is designed for general 
communications while the zip queue is specificalty to be used for 
job spawning controt. . 
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YSER COMMAND 


Syntax: USER <usercode> (/<password>]) 


Description: 


The USER command provides away of invoking the file security 
mechanism and the associated naming canventione The USER commana 
causes the MCP to verify the usercodes and/or password» against 
the system usercode/password file. The usercode 1s carried with 
the control string and is used to obtain the information to appty 
the RJE naming convention to.any subsequent fite nase reference. 
For exagspte» the string "US AL PD =/=" would generate a name in 
the PD of *"<PACK“ID>/€AL)/="» where the packtid and the usercode 
"(CAL)" were obtained from the systesx usercode file. In additions 
the usercode index is stored in the Run Structure Nucleus of jobots 
zip executed with a USER command and is used to apply the &ARJE 
naming convention to any files the job may open durtna execution. 
A detailed description of file security is provided in a tater 
sect i0ne 


The underscore under US tnmplies that. the first two characters are 
necessary and the rest are optional Ce.ge» US and USER are both 
valid). 
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SESSION COMMAND 

Syntax: S$2Z <integer> 

Description: 


This ts mainly an RJE controt card. It would not te invoked in 
the course of simple job spawning. The session nusber generated 
by an SZ command is carriec with a “zipped” control string and 
applied to a job or mix of jobs deperding on what other commands 
are in the control string. The primary function of the session 
number is to associate independent jots into togicatty related 
groupse For examples HOST RJE assigns a session number to a 
physical site at logton time and alt jobs subsitted from that 
site will contain identical session mumbers» thus relating them 
to the originating remote site. In general» session numbers are 
routing controt numbers that the spawning job can assign to 
executes or other zip strings» and the returned messages in. the 
spawning queue will have the same session numters. 
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RESTRICTIONS COMMAND 

Synt ax: RR <integer> 

Description: 


The RR command assigns a RESTRICTIONS vatue tc a job. The value 
way be O» Ll» 2» or 3% the default value is 9. The restrictions 
concern whether a job wiht be allowed to access printer and cards 


directty and whether a usercode is required with certain controt 
input commands. a 


Jobs and zips with an RR value of 0 can access frinters directly» 
can access card devices directly» and do not require usercodes 
Cuntess they reference jobs that were started with a usercodes in 
which case the same usercode/passworda is required). 


Jobs and zips with an RR value of 1 cannot access oprinters 


directly» can access card devices directiy» and do require 
usercodes on some commandse (See the section on “SYSTEM INPUT 


MESSAGES* to ‘determine exactly which cogmands require 
usercodes/passwor ds-e ) . 


Jobs and zips with an RR vatue of 2 cannot access printers 
directly» ‘can access card devices directly» and do not require 
usercodes Cunless they reference jots that were started with a 
usercode). 


Jobs and zips with an RR vatue of 3 cannot access printers 
directly» ‘cannot access card devices directly» and do require 
usercodes on a subset of system input commands (see the “SYSTE™ 
INPUT MESSAGES” section). 
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CONTROL QUEUE MESSAGE FORMATS 


Messages received in a control queue have a standardized 50° 
character header as fottlows: ; 


le Message type of 2 characters. 


Type 01 -°- RJE data carc lahbet message 


Type = 092 = RJE special schedule message 
Type = G63 = RJE SPO input message 

Type = 04 = RJE SPO output message 
Type = 05 = RJE speciat B0J message 

Type = 36 = RJE special EOJ message 

Type = 97 ~ RJE backup ready message 
Type = 08 = RJE zip message from progran 
TYPE = 09 = RJE status change w#essage 


2e Job number of 5 characters. Ww 7 


3. Usercode of 16 characters. 

he Session number of Stnapaceeres 

Se Time stamp of 6 characters. 

6 Actuait size of following textual message of 
Te Usercode index of four characters. 


Be BNA noce address of five characters (709C00" ae ers 
9» Reserved space for use of characterse Cr Cy 


The textual portion of the messages varies according to the tyre 


of message. In generat» the kind of text that can be expected 
for the individual messages is as follows: 
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Type Cl The first 19 characters contain the actual tatel 


Type 02 


Type 03 


Type 04 


| Type 05 


Type Q6 


Type 98 


detected by the MCP on a DATA card (Ceegee "CARDS*"). 
Note: This message only appears in the “*zip"queuee 

The first 12 characters with contain the user's 
packwid» if the next character = “11> then an FW 
command is needed» and the next five characters contain 
the summary backup number. €5ee note thetowe) The 
additional information beyand the header is: 


user*s pack*id CHARACTER (14) 

FW needed (="1") CHARACTER ¢€ 1) 7 

Summary backup nusber CHARACTER (€ 5) ONLM, 

SNA hostname where message CHARACTER (17) 
originated 

Nonwnative ftag C="1")3s — CHARACTER (€ 19 


cooperating BNA host is 
not a 81990 system 


Standard SPO input text Ceeges *LAX*="""""), 


Standard output text which would normaily appear on the 
5P0. 


CNone.) 


First 2 characters indicate the tergination type» ang 
the next 4 characters contain the compiter error count» 
if any- Termination type value indicate the following: 


normal EOJ . 

DS or OP - 
Error conditior in progras (syntax errors 
or CANCELLED) ‘ . 
Aborted | 

RS~ed 

Death in Family 


wm Oo 
ion ow 


Wi & Ww 
hou oi 


The first\character indicates ywb#t type of tackup file 
was createW ("#" = prints “3 = cunch). The next five 
characters ae the backup-fumber used in naming The 
file. The Nast. sharacters are the packrid. For 
exagapte» the swaing“"43" indicates a print backup file 
which has an 4 ai RJE backup file name of “<user 
packrid>/<user?d The tackup number is stored 
left justi fied ye character field. 


If a job which has a par@nt queue with the LS option 
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set does a ZIP» this message and the text portion of 
the ZIP are placed in the queues. | 


Type 09 If a job*s status changes so that the job needs 
operator intervention to continue running» or if a joo 
is resumed fottlowing such a candition» an encoded 
status change message is written to the job spawning 
queue. Its format beyond the header is: 


encoded status vatue CHARACTER (€ 3) 
text» which may be CHAR c) 


fide naswes» the DS 
message» or nullo 
depending on the status 


The reported status values» their meaningss and the additional 
text that is reported with them are as follows» where "fn" in the 
"text" column means “"40~-character internat and external file 
names*» "“dbn"™ means database nawes» "tnm” means “translate 
filecid™» and "pn" means “program nameo” | 


Value Meaning Text 
fy executing ("resumed") 
eee _ 
2 no user disk . fn 
on duplicate file on disk fn 
4 duplicate input files fn 
“5 possible duplicate fr 

multipack file 

6 ; waiting for hardware fn 

4 program stopped 
11 waiting keyboard inrgut 

13 waiting operator action 
15 waiting DS or OP DS message 
16 no multipack file pack fn 
17 no file on disk fri 
18 waiting for tocked file fr 
35 no network controller fn 
36 no output pack fn 
37 missing sort intrinsic er. 
38 no sort input: file fn 
41 waiting recovery dbn 
46 waiting forms on printer fn 
47 no translate file fn + tnm 
49 no dms file fn 
59 no dms dictionary dbn 


51 waiting dms reorganization dbn 
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52 waiting inactive data tase fn. 

53 security error fn 

60 missing calted program pn 

61 BNA not present . fn 
Note: Jobs requiring card fites are fut into the waiting 
. schedule. This prevents the BOJ from occurring before 
the card file is actually present. It then tecomes 


RJE/CONTROLLER®s respcnsibility to move this job from the 
waiting schedule to the active schedule when the remote 
card file is presente This is dane with the FW (CFORCE 
WAITING) command. © 


NEW RUN STRUCTURE NUCLEUS ETELDS 


Five new fields have been added to the Run Structure Nucteus 
which contain the necessary. information for job spawning control. 
The fields are the following: : 


le RSeUSERCOOCE €15 bits) Contains the index into the system 
; usercode fite obtained from the US command. 


2e RSeSESSION C16 bits) Contains the binary representation of 
the session number from the SZ commande 


3. RSeLOGeSPO (1 bit) Pocitean set as a result of the LS 
commande 


4. RSw~PARENT.QUEUE (24 bits) Contains the actual address of the 


controt ‘queue of the parent job which was obtained through 
the QU command. . 


De RSePARENT.JOB»NR (24 bits) Contains the jot number of the 
parent program. 


DISK“FILE AND SYSTEM-ACCESS SECURITY 


The BLB8GO/E1L700 system provides a mechanisn for identifying 
System users» limiting system access to valid users» and 
restricting disk-“file operations ty securing disk files against 
operations by users other than the owners of the files. 
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Each individual user of the system is identified by ai unique 
usercoder which is normatly assigned by installation management. 
One or more passwords may be associated with each usercode to 
prevent unauthorized use of the usercode. system access control 
is achieved by requiring a user to specify usercode/password 
before any useful processing is perforwred. Basic file security 
is achieved cy associating a given user's files with his 
usercode. By default» a user is restricted to accessing his own 
files. Mechanisms are available for a user to access a 
systeacglobal library of files» and files in another user's 


library» subject to constraints placed by the owners of those 
files. 


Inst allations not desiring to use file security may ignore it ana 
then run without any changes to their existing systemse 


USERCODES AND PASSWORDS 


Usercodes and passwords are identifiers. A usercode may be up to 
eight characters in tength and a password may have from LI-Li 


elas = | ov blank 


The usercode is defined by its appearance in a fite cattea 
CSYSTEMI/SUSERCODE> which is maintained by installation management 
to keep information about system userse Facitities to create and 
maintain this file are described in the product specification on 
the SYSTEM/MAKEUSER program. 


SYSTEM ACCESS 


Initial access to the system is achieved by entering a job 
through a card reader Cor operator console) or by entering 
information from a terminal via the ODatacogm systene In the 
former casee the access is cantrotled by the MCPs in the latter 
case» a Message Control System (MCS) progras is involved. 


A usercode may be associated with a job by including a USER 
statement preceding the job statements. This jot wilt have the 
specified usercode.e. The user statement has the form: 


USER usercodel/password]l 
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The C€/password) is omitted if no password is associated with the 
usercodee. 4 USER card entered at a card reader remains in effect 
untid the end of the job. 


Individuat control prograags way accept or recuire usercode 
specifications. CANDE requires att users to tog on with a 
usercode. The USER statement is used in RJE jobs as it its in MCP 
jobse $$In addition» RJE has the capability of runring each joo 
with a default usercoder ieG@e» the one with which the terminal 
was logged on. 


FILE=NANING CONVENTIONS 


Disk files created by a program cunning with a usercode are 
associated with that usercode. In normal situations» the user 
supplies an arbitrary file nane Ccoansisting of 1 to tt: 
char acters); the directory structure prevents confusion of that 
file with any other user*®s file of the same name. All the files 
in a given usercode library “belong” to that user. A user may 
not create a new fite that does not "belong” to him Cut may» . 
however» legitimately require access to general system files and 
those of other users. To facititate this access» the following 
canventions have been adopted: 


ae An asterisk of a multi-file ID indicates that the file wilt 
he found among the general systen filese For example: 


FILE F CNAME="*#SYSTEM*/" CARDLINE™ D3  & SOL file 
: % dectaration 


The actual name of the file in the MCP"s file directory will 
be SYSTEM/CARDLINE. , 


be Parentheses around the multisfile ID of a file nase indicate 
that the identifier is a usercode and that the file» the 
title of which consists of the FILE.1ID wilt be found among 
the files belonging to that USEL es 


FILE F CNAME = CHI SUSER) */"HISDATA™) 3. % SOL syntax 


The actual name of the file in the MCP*s file directory wilt 
be CHISUSER) /HISDATA. 


Ce In the nornal case» when neither of the above conventions is 
used» then the search will begin with files belonging to the 


usere If the file tis not found» the search witl continue 
among the general system files. 
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Attempted use of the “*" or (C<usercode>) conventions to create a 
new permanent file is a security vielaticn under the fottowing 
conditions: 

1. If the program is not running under a usercodes 

Ze If the program is running under a nonsprivileged usercode 


and its usercode is not the sane as the usercode of the file 
being created. 


The following examples are syntacticaliy correct. 


RUN CARD EXAMPLE? EX CHISUSERI/HISPROGR AMS 


LABEL EQUATION EXAMPLE: FILE 222 NAME = *#SYSTEMFILS 
FILE SECURITY IMPLEMENTATION 


Two fields were added to the disk file header to support file 
security. 


DFH. PROTECTION BIT (€2) 


.0O = PUBLIC 
1 = PRIVATE 
2 * GUARD Cnot implerented) 


OFH.PROTECTION.IO BIT €2) 


Q - INPUT OUTPUT 
1 - INPUT ONLY 
2 - GUTPUT ONLY 


One SPO command was implemented to change these fields. 


WH <FILETIDENTIFIER> SEC PUBLIC 
PRIVATE 
SUS INPUT 
GUTPUT 
1.0 
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Two fields were added to the FPB. These are used to set the 


fields in the disk file header. 
FPB.PRCTECTION BIT (2) 


QO ~ CEFAULT 

1 - PUBLIC 

2 = PRIVATE 

3 = GUARD Cnot implemented) 


FPBePROTECTION.IO BIT (2) 
Q - INPUT QUTPUT | 


1 = INPUT ONLY 
2 =~ GUTPUT GNLY 


Two new file attributes can set these FPS fields. 


SEC or DEF AULT SUS or 1.0 

SECURITYTYPE PUBLIC _ “SECURITYUSE INPUT 
PRIVATE gUuTPUT 
GUARD 


Upon aocking a new disk file into the directcry the MCP will set 
DFH. PROTECTION.I9O to  FPB.PROUTECTION.I( then look at 
FPB8.PROTECTION. If it is zero CDEFAULT)» then DFH.PROTECTION is 
set to PUBLIC if the MULTI.-FILE.~ID does not contain a USERCODE. 
Howe vere vf the MULTI-FILE-IC does. contain a USERCODE, 
FPB.PROTECTION witl be set to the security attribute of the 
user codes 12Ces PUBLIC or PRIVATE. If FPBePROUTECTION is not 
equal to zero» DFH.PROTECTION is set to FPS8.~PROTECTION Less one. 


BURROUGHS CCRPORATION 
COMPUTER SYSTEMS GROUP 
SANTA BARBARA PLANT 
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USERCODE naning conventions and FILE SECURITY is enforced at open 


ti 


nme based 


upon the following decision tabte. 


not reflect PUBLIC or PRIVILEGED USERCODES. 


te MULTI.FILE.ID * 


khk&hkhkkkakkk&hh kth 
« JOB RUNNING * 
* WITH A fe 
* USERCOCE & 
KRERKEKKKAHR RK HK 
akkhktkkkkkhkkkkekkikhkkkhk kh kkkake NEW *« OLO fe 
PACK.ID * FILE * FILE *® 
RECA KERR ERK EERE ERAKKREERKEKREKKRRREE KKK 
kk ARERR REE RRR RE RRR RE RE RE RR 


* x BLANK * A * B 
& BLANK kkakkkkk hk kkkkkkhkkkkae hhh kh kh 
& * PRESENT al G * K # 


ree REM SRERERSLRE SE ARSE SEER ERI RC RES ERE SRR ESLER SSE ES 
(SRR REPRE REMAP E RE RER RES Se TRS R ERE RERE SERS RSS RES SS 


i * FLANK * dD I * 
* USERCEDE kkuetkhkk kh kk ki kk tkkekk kik ehhh 
& * PRESENT x Fo Hq & 


TREE CLSLCCCLCCLCICTSCLCLLCSL ICCC LSAT TT eT TTT eet 
&k&aekak kk kk akkkkkakhkk ke kkahkkhkk kk eh kk kkkkeakek hk hkkhkkkk kh 


x ASTERISK IN * BLANK « LL * MO ff 
* FIRST. RAKE KKKKEKKKKKENKKEREKKEKKEKK a 
* POSITION « PRESENT f L «* Mo of 


KREWAKKEKEKRKEMKEUKREHREREKKKEEKEKA RE KKEKKRKEKKKEKKKKEKKRKRKEREK 
ee ake EKKaE KAKA KRKEREKKKKKaRK KKK ae Kkkke Raha kk eK 


* . * BLANK © id P « C « 
* PRESENT KRKKEREKKEKRE KK KKK KKRKKKKKRKK a 
ts * PRESENT & P «* Cc «* 


RKKEARKHREKKE REE KKK KEKRKKKKK KK RK KKEKRAKKEKK KKK 


This tabdte does 


&kkkaxk&akkk&hkkhkk 
* JOB RUNNING * 
* WITHOUT A * 
* USERCODE « 


RRAKKEKKKREKEK HEA K 


* NEW * GLD * 


® FILE * FILE * 


kkththk&&hthkkak ek ak kk& th 
kkkkhkaRAKRHeKKkA SL 
* OPEN « C * 
Kkkk&HKkKkK&aakKREAaE SE 
* OPEN * Cc «* 
REAR KKEKAAKEKRENKE EK 
R&kaAKKkKAKkKkKk kkk KK 


* 8} * C. we 
whith kk kk kh kk hk k 
fe a & Cc fe 


KkaKRaRKKKKKE KEK 
kkthk&khkkkhkkhkaikkk 
« J * N & 
kaekkkkhkaekakkk kkk 
&* J x N & 
RRAKRKAKKAKEKKKE 
kkkkhkhkkkkaehkekek 
* OPEN * Cc * 
&Rkkkekkk kk ke keh 
* OPEN * CC «& 


RHEKKKKKKEKEKK EK 


Table 4.1 Decision Table 
Where: 
Ae Le Set PACKeID from the USERCODE table using the USERCUDE 
under which the program is runninge 
2e Set the MULTI.FILE.ID with the USERCODE under which the 
prograr is running. 
3e Attow OPEN to proceed. 
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Be le Set the PACK.ID from the USERCODE tattle using the USERCODE 

under which the program is running. 

2e Set the MULTI.AFILE.I0D with the USERCODE under which the 
program is running. 

3e Search directory. 

4. If the file is present allow ‘ehe OPEN to proceed. 

5e Clear the PACK.ID and the MULTI.FILE.ID. 

6-e Proceed in step C. 


Ce. 1- Search the directory. . 
2. If the fite is not present then hang the program NO FILE. 
3e Proceed to step R. 


De Le fF the USERCODE in the AULTI-FILE.ID is not the same as 
the USERCODE under which the program is runnings then the 
job is DS-ed. 

22 Set the PACK.ID from the USERCODE tatie using the USERCODE 
in the MULTI.FILE.ID. 
Ze Allow the OPEN to proceed. 


Es» le Set the PACK.ID from the USERCODE file table using the 
USERCODE in the MULTI.-FILE.ID. 
2e@ Search the directory. 
3. If the file is present then proceed to step Re 
4. Clear the PACK.1I0- 
5=- Proceed to step C. 


Fe 1. If the USERCODE in the MULTI.LFILE.ID is not the same as 
the USERCODE under which the prograr is runnings then the 
job is DS~-ed. 

2e Attow the OPEN to proceed. 


Ge Le Set the MULTI-FILE~ID with the USERCODE under which the 
program is runninges 
2e- Allow the OPEN to proceed. 


He ie If the USERCODE in the MULTI.FILE.~ID is not the same as 
the USERCODE under which the program is running» proceed 
to step C. 
2e Search the directory. 


3e If the file is not present hang the program NU FILE. 
&. Atitow the OPEN to proceed. 


4-23 


BURROUGHS CORPORATION COMPANY CONFIDENTIAL 
COMPUTER SYSTEMS GROUP BL8CO/BL79G HOST/RJE SYSTEM 
SANTA BARBARA PLANT Pe Se 2219 9136 CE) 
Ie le Set the PACK.ID from the USERCODE table using the USERCQODE 
in the MULTI-FILE.10D. 
2e Search the directory. 
3. If the file is present proceed to step Se 
4. Clear the PACK.ID. 
Se Proceed to step He. 
Je 1. Remove the asterisk and shift the name left cne position.e 
2e Allow the OPEN to proceed. 
32 At CLOSE time proceed to step Te 
Ke Le Set the MULTI.LFILE.ID with the USERCODE under which the 
program is running. 
206 Search the directorye 
3» If the file is present» allow the OPEN to proceed. 
4. Clear the MULTI.FILE.ID. 
Se Proceed to step C. 
L. 1. Remove the asterisk and shift the name Left cne position. 
@e If the resuitant name is a USERCOCDE» proceed to step F. 
Ze Allow the OPEN to proceed. 
4. At CLOSE time proceed to step U. 
M. Le Remove the asterisk and shift the name Left one position. 
2e If the resuitant name is a USERCOOE» proceed to step He 
3-2 Proceed to step C. 
Ne Ls Remove the asterisk and shift the name Left one position. 
2e Proceed to step C. 
Qe te Set the PACKeID from the USERCODE table using the USERCODE 
in the MULTI.-FILE.I0. 
2e Proceed to step W. 
Pe 12 Atltiow the OPEN to proceed. 
2@e At CLOSE time proceed to step Ue 
Ge 1. Oispiay security error message. 
2e Hang program NO FILE. 
Re Le If the GPEN violates file security» proceed to step 9. 
? 


Aitlow OPEN to proceed. 
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Se Le If the USERCODE in the MULTI.LFILE.ID is the same as the 
USERCODE under which the program is runnings then altow 
the OPEN to proceed. 

22 Proceed to step Re 


Te Le If the program is attempting to tock the file into the 
directory and the MULTI.FILE.ID contains a USERCODE, 
then proceed to step Ve 

22 Aitow the CLOSE to proceed. 


U. 1. If the MULTI.FILE.~ID does not contain the USERCODE under 
which this program is running and the program is attempting 


to lock this file into the directcry» proceed to step V. 
Ze Attow the CLOSE to proceed. 


Ve Le. Otsplay an error messages 
2e Oiscard the fite. 


We Le Attow the OPEN to proceed. 
Ze At CLOSE time proceed to step JT. 


FILE ACCESS 


Access to a given disk file is controlled by two attritutes of 
the files SECURITYTYPE and SECURITYUSE. 


The SECURITYTYPE attribute specifies who» apart frog the owners 


may access the fitee. The attribute values are “*PRIVATE"™> 
"PUBLIC" or “GUARD. “"PRIVATE™ means that only the owner may 
access the file. “PUBLIC™ means that anyone who knows the 


usercode and tittle may access its using the "Cusercode)/titie” 


form of file namew “GUARD” indicates that the file is “guarded™. 
The default value of SECURITYTYPE is PRIVATE for files created by 


programs run under a usercode with a PRIVATE security attribute 
or PUBLIC otherwise. 


Note: The “GUARD™ attribute is not inmplerented. 
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The use which may be made of a file is further controlled by the 
SECURITYUSE attribute» which may have the values IN» OUT» and Id» 
indicating respectively that the file way te read criy» written 
onty» read or written. The default vatue is I[0.- 


lf a progras running under a usercode attempts to access a file 
in that usercode library» SECURITYTYPE and SECURITYUSE are 
ignored. If a file in some other usercoce library is accessed» 
three cases arise. 


1. If SECURITYTYPE is PRIVATE» a security viotation exists. 


Ze If SECURLITYTYPE is PUBLIC» usage is determined by 
ji SECURITYUSE. 


3» A SECURITY error is caused if some action contrary to the 
aitltowed usage is attempted. 


Execution of a code file by a nonowner is permitted for a PUBLIC 
file independent of SECUKITYUSE. If a cade fite is PUBLIC» READ 
ONLY» it cannot be opened by any one excerpt the cuner. 


The security attriputes for a file ay be specified by the 
security file attributes or programrmaticalt y» or by the SPC. 
Only a job/task running under the usercode for the file may alter 
the security attributes. | 


FILE CREATION 


A program running under a usercode cannot create and tock into 
the file directory a file with a different usercode» nor can it 
create a system file Ci.e. a file name which begins with 3 an 
asterisk). A program may open a new system file for temporary 
usage but it witd not be allowed to close that fite with lock. 
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PRIVILEGED USERCCOES 


A job running with a PRIVILEGED USERCODE has a special status. 
If the names of the disk files that are opened contain onty a 
FILE .ID» the RJE naming conventions will ce exercised. However» 


the program may also supply the PACK.ID and MULTI.FILE.I9 and 
never violate RJE naming conventions cr file security. 


PUSLIC YSERCODES 


If a usercode is given the "PUBLIC™ attribute (cof. PeSe 2249 
Q1025 SYSTEM/MAKEUSER) then all files created Ciee€er Locked into 
the disk directory) wilt have the default DFHePROTECTION set to 
PUBLIC. Thus if the OFH.PROTECTION is not explicitly set to 
PRIVATE Cor GUARD) full access to this new file is allowed to any 
other programe whether running under a usercode or not. 
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GENERATING THE NETWORK CONTROLLER 


RJE/NOLDCH» which is the network controller for RJE» requires the 
user to write NDL specifications to generate the specific network 


controtter. The foltowing List of guidelines is intended to aid 
the user in generating the correct NOL. Please refer to 
9L8G0/B8 1709 NOL Manuale for extencea specifications and 


definitions. 
Le Program Name 


The network controller and "NIF" file are here defined a5 
RJE/NOLOCH and RJE/NOLOCHNIF. It is not necessary for then 
to be so named. 


Ze Dectaration Section 


The only required entry is the specification for the NIF 
file name: 


NIF = “"RJEW/°NDLDCHNIF*. MAX FILES 


2. MAX BUFFERS = 2. 
MAX MESSAGES = 20. MAX MESSAGE SIZE 


411. 


ou 


30 Request Section 


The required request section 1S contained jin the NOL 
Library. It ts named "RJEHOST®*. 


$LEIBRARY RJEHOST 


he Controt Section 


The required control section is contained in the NOL 
Library. It is named "RJECTL®. 


SLIBRARY RJECTL 


5. Terminal section 


Onty one terminal entry in the terminat section is required. 
Any other vatiues may be used for the rewaining statements 
fossible within the terminat section ("TYPE™ and the name 
specified for the terminal). 


Note: Untess a user written FWCS ts supplied» the “TERMINAL 
DIAGNOSTIC REQUEST” statement cannot be utilized. 
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Ge 


Required terminat section. statement se 


BUFFERSIZE = @2). 

ADCRESS = 2. 
REQUEST = RJEWHOSTS RECEIVE» KJES TRANSMIT. 
TRANSMISSION = 1. : 


Note: The RJE request section is used both for transmitting 


and receiving. 
Station section 


Four stations are used with RJEHOST for each tine to te 
used» each of which references the one terminal section 
cefined above. It is recommended that the retry Limit te 
set at 25 and that the input and ocutpfut frequencies te. set 
to identical values. 

ee, 


The "MYUSE" statements must be set as fotlows: 
MYUSE=INPUT»OUTPUT. 


The addresses for the fcur stations must have the following 
values: a, 


“007 FOR STATION 1 6% 
"O01" FOR STATION 2 lb Ko = 

")2" FOR STATION 3 

"03" FOR STATION 4&4 


A maximum of 64 RJEHOST stations is possible. Each series 
of four stations must have the addresses specified above in 
the order tisted above. RJEHOST stations aay only te 


defined in blocks of four at atime» as each series of four 
stations defines one remote user on one line. ine 

The RJEHOST stations in the network controtler must be the 
first stations defined. If other stations are to be defined 
in the network controller» it is absolutely necessary that 
they fottow abl RJEHOST station definiticns. 
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7» Line section 


The address of the adapter of the tine to be used is 
specified in the tine section. This address will vary froma 


System to systeme The station statemert aust reference the 
four stations defined above. 


The fotlowing is a list of required statements in the tine 
section: 


PsCtA. (CWhere P = Port 4d» 


ADDRESS = = 
C = Channet #» 
A = Adapter 4) 
STATION = STATION LIST. 
CONTROL = 


RJECTL. 
A maxinus of 16 RJEHOST Lines is permitted. 


File section 


One remote file is required. It is necessary that the 
following file section be used? 


FILE MCSQUEUE; 
FAMILY = Sls S2eS3%S4035e S957» She SI eSIO wm SL Le Si2recenee 
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9» Sample NDL RJE dectaration: 


The foltLowing is a sample NDL RJEHOST declaration for a 
network controtler servicing three remote sites. 


200 RJE/NDLOCH NDL 
2D ATA CARDS 
DECLARATION: 
NIF="RJE"/*"NOLDCHNIF". 
MAX FILES = 2. 
MAX BUFFERS = 2. _ 
MAX MESSAGES = 20 
: MAX MESSAGE SIZE = 411. 
SLIGRARY RJEHOST 
— $LIBRARY RJECTL 
TERMINAL B1700: 
TYPE=62. % 1700 
ADDRESS=2. 
BUFFERSIZE=820. 
TRANSMISSION=1. 
REQUEST=RIJEZRECEIVEs RIES TRANSMIT. 


STATION DEFAULT OF: 
TERMINAL=8617¢60. 
RETRY=25. 
FREQUENCY=255»255. 
MYUSE=INPUT, OUTPUT. 


% 

% PHONE = “<phone.number>" 
% THIS STATEMENT IS. NOT USED IN THE CURRENT 

% IMPLEMENTATION OF CALLBACK : 
% 


STATION Si? 
DEF AULT=0F. 
ADDRESS="90". 

STATION S22 

DEF AULT=0F. 
ADDRESS="01". 

STATION S3: 

OEF AULT=DF.. 
ADDRESS="02". 

STATION S4: 

DEF AULT=DF. 
ADDRESS="93". 


STATION $5: 
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DEF AULT=D0F. 

ADDRESS="00". 
STATION Se: 

DEF AULT=0F. 

ADDRESS="91". 
STATION S73 

DEF AULT=DF. 

ADDRESS="02". 
STATION S6: 

DEF AULT=DF. 

ADDRESS="03". 


STATION S93 
DEF AULT=DF. 
ADDRESS="06". 
STATION S10: 
DEF AULT=0F. 
ADDRESS="01". 
STATION Sti: 
DEF AULT=DF. 
ADDRESS="92". 
STATION $12: 
DEF AULT=0F. 
ADDRESS="03". 


LINE Li: 

ADDRESS=7212:9. 

CONTROL=R JECTL. 

STATION=Si» S2» S35 She 
LINE L2: 

ADDRESS=1:0 26. 

CONTROL=RJECTL. 

STATIGN=S5» S6» S7» S®@. 
LINE 13: 
ADDRESS=130 230. 
CONTROL=RJECTL. . 
STATION=S9e S10» Sil» $12. 


FILE RJEQUEVE 
FAMILY=S19525S3 9549559569 S758 oSIeSLOeSiLeS1l2- 

FINI 

7END 
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CHANGES FOR MARK VWII.Q RELEASE (0D) 


All references to 81709 changed to 81895/81709 


Added F. (Automatic CALLBACK feature) 

Added "ALi decks must te terminated by a "?END® 
card” to REMOTE DECKS 

Added Remote Output Messages 16 through 19 

Added *PH to mnemonics of keyboard entries 

Added *PH Input Message 

Added CALLBACK to runvrtise remote terminal options 

Added Format 2 (#10 <option nase>) to *T0 Input 
Message 

Underlined Systea Input Messages BF» CHe COs DF» 
EX» MH» MO» QF» RBe and RE to indicate these 
commands require a valid usercode and password 

Added RJE Host Systew Qutput Error Messages 18 
through 21 ~ 

Added “Each tine may have only cne remote sateliite 
systefteeoe” to Generali Description of RJE Controtle 
Added CALLBACK 

Indicated only first two characters are necessary. 
for vatid syntax of QUEUE cosrand 

Indicated onty first two characters are necessary. 
for valid syntax of USER command 

Indicated two security violation conditions with 
attempted use of the “** aor (<usercode>) 
conventions 

Table 4°1 reviseds discussion of A“N reviseds furtl 
discussion (O°W) addec 
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